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The magnitude of Calamus and its family of related 
products is difficult to describe in multiple pages of 
advertising. This one page is our attempt to give you 
a very general feeling of this powerful product line. 



"How does Calamus stack up to the "big guns" on other computers? Option 
for option, Calamus is comparable to, or surpasses, the desktop publishing 
competition." 

"Without a doubt, Calamus is the most daring entry into the desktop 
publishing market in years. It's a powerful program that incorporates all 
the best features of existing publishing products into a fast, easy to use 

product." 

Start Magazine May 1989 

Linotype Interface 

The Calamus Linotype interface 
connects directly between the LI2 port 
on the Linotype Imagesetter and the 
DMA port of the Mega ST, bypassing 
the Raster Image Processor. Up to 2540 
DPI generated entirely within Calamus. 

The Calamus Vector Font Editor 

For the creation and manipulation of 
Calamus "Designer" fonts and 
graphical objects. 
A partial list of features include: 

- A Graphical Interface 

- Snap for Background Image 

- Freely Adjustable Help lines 

- Automatic Kerning 

- Two Sizes for Presentation 

- A Clipboard 

- A Built— in Calculator employing 
Italics, Free Rotation, Mirror 
Imaging (Vertical/Horizontal), Font 
Condensing... 



Calamus is a powerful, professional 
desktop publishing solution at an 
affordable price. 
A partial list of features include; 

- Outline font technology that 
produces identical results on both 
the printer and the screen, for 100% 
true "WYSIWYG" 

- Fonts can be scaled from 1 to 999.9 
points in 10th of a point increments 

- Text can be rotated 360 degrees 

- Printer output to the Atari SLM804 
300 DPI laser printer is very, very 
fast 

- Multiple clipboards throughout the 
document 

- Complete MACRO capabilities 

- A built-in-Text Editor 

- User definable view of up to 999 % 

- Multiple Master Pages (Style 
Sheets), Multiple Page Layouts and 
300+ additional features 

ft ft ft ft ft 



A partial list of Compugraphic fonts for use with Calamus 

Antique Olive 

ITC Avant Garde Gothic Book 

Bauer Bodoni 

CG Century Schoolbook 



Cor 

Dom Casual 

English Times Extra Bold 

Futura II Book 

Garamond 

Isabella 

ITC Korinna Regular 



SJJobern 331ackletter 
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CG Palacio 

"Raphael 
Revue Regular 

Schneidler Black 

•Signet- &tacwc//iand 

IlG Souvenir Medium 

CG Triumvirate 

Typewriter Large Elite 
Uncial 

Univers Medium 
Univers Extra Bold 

Peoimtg Sexi 

ITC Zapf Chancery Medium 

Zapf Dingbats arKIS-ft ►}- 




Calamus Outline Art 

This vector graphic editing program 
offers you nearly unlimited possibilities 
for the manipulation of text, letter and 
font attributes. A few examples include: 
sending text along any path including 
waves, circular text, enlarge, compress, 
bend, stretch and distort any of our 
outline fonts. Generate smooth raster 
gradients in any direction, ray objects 
and project lines as rays. Project text 
onto a globe, cylinder or cone. Lines, 
Bezier curves and control paths are 
easily definable. 




For more information please contact 

your local Computer Dealer or contact 

us directly 



ISD Marketing, Inc. 



Tel: (416) 479-1880 Fax: (416) 479-1882 

Note: This page has been created entirely within 
Calamus and Calamus Outline and output at 1270 DPI 
on a Linotype L300 Imagesetter. Compugraphic® is 
the registered trademark of the Compugraphic 
Corporation. Calamus® is the registered trademark 
and tradename of DMC/Ditek International, 
represented exclusively in North America by ISD 
Marketing. 
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fell, here we are: the first issue of the new ANALOG Computing, 
your one-stop magazine for coverage of all Atari computers. We've 
worked hard to ppt together what we feel is the best Atari maga- 
zine value available anywhere, and we hope that, once you have 
had a chance to look through it, you'll agree. 

Because we are now the largest Atari-specific magazine, we have plenty 
of room to stretch out. We've managed to cram into these pages all of the 
features and columns that both ANALOG Computing arid ST-LOG readers 
have come to expect. Nowhere else can you get over 130 pages of reviews, 
programs, tutorials, columns and features designed to help you get the best 
from your Atari computer.; No matter which Atari computer you own—an 
8-bit or an ST— the new ANALOG Computing is one of your best in- 
vestments. 

Of course, we can't claim this issue is perfect. We've done the best we 
can, but we need your input in order to help us fine-tune ANALOG Com- 
puting so that it is exactly what you'd like it to be. So please, sit down and 
read through this issue; then, while it's fresh in your mind, jot us a quick 
note. Let us know what you like and what you don't like. If there's some- 
thing new you'd like to see; tell us. ffcur opinions are important. This maga- 
zine is, after all, for you. HM 

Those of you with subscriptions may be wondering exactly how the com- 
bining of the magazines will affect you. As you know by now (you are hold- 
ing this magazine in your hands, after all), subscribers to either ST-LOG 
or the old ANALOG Computing will now get the new ANALOG. Those 
who subscribe to both magazines will have their subscriptions combined and 
extended. For example, if you have six months left on your subscription to 
ANALOG and nine months left on your subscription to ST-LOG, you will 
now get 15 months of the new ANALOG. In the months to come, we will 
continually improve ANALOG Computing, incorporating your suggestions 
and making-sure all of you feel that you are getting the best possible maga- 
zine for your money. All we ask is that you write that letter. Write it today. 
I'TFill our mailbox to overflowing. We want to know what you think. 

spouses to this editorial should be sent Jo ANALOG Computing, P.O. Box 
1413-M.O. , Manchester. CT 060404413^f/Kt^mmmm^ m 
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SURVEY SWEEPSTAKES 




DIALOG BOXES 
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— Memory Match 

A sound-enhanced version of the ever popular concentration-type 

matching game. 

by Joe Brzusxek 



I Title Maker 

This utility will help you create attractive title screens that remain on your 

display as your main program is loading. 

by Larry Black 

I BASIC Utility Package 

BASIC programmers will enjoy this set of RAM-resident 

programming utilities. 

by Barry Kolbe 



Atari U.K. Shew 

Come with us on a short tour of a recent ST show in merry old England. 
by Marshal M. Rosenthal 



fi Survey Sweepstakes 

Here's your chance to play a version of a popular TV game show on 

your Atari. 

by Albert Baggetta 

60 
The Assembler/Editor Reference 

For those who purchased the Atari Assembler/Editor cartridge without a 

manual, help is on its way. 

by Matthew J.W. Ratcliff 



The 1989 ANALOG Gift Guide 

Need some gift ideas for that special computer person? 
by Arthur Leyenberger 

The Animation Stand: Special Effects 

Maurice explains how to add some unusual effects to your 

computer animations. 

by Maurice Molyneaux 

114 



Dialog Boxes with GFA BASIC 3.0 

Part 1 of a complete tutorial on programming dialog boxes in this 

popular language. 

by David Plotkin 



rjTTi'l This program runs In both color and mono. 
,5=' II Is available In type-In form & on the disk. 



|| T"| | This program runs In color only. 

,-s=d II Is available In type-In form & on the disk. 



|| m || This program runs in mono only. 

,'=={ It Is available In type-In lorm & on the disk. 

yz^ji This program runs in both color and mono. 
t=J It Is available only on the disk. 

(No Image) This article does not have an associated program. 



I This program runs in color only. 
' It Is available only on Ihe disk. 

j This program runs in mono only. 
It is available only on Ihe disk. 




49 Changing Patterns 

by Matthew J.W. RatcllH 

50 MT-32 Controller 

by Michael Frtesen 

51 Airball 

by Matthew J.W. Ratcliff 

52 Talespin and STAC 

' by D.A. Brumleve 

48 The ST Oameshelf 

This month Ballistix, Batman, Captain Fizz, 

Twilight's Ransom and Speedball are reviewed 

by Frank Eva and Steve Panak. 
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7 C-Manship 

by Clayton Walnum 

14 The Personal 
Publisher 

by Donavan Vicha 

33 lan's Quest 

by Ian Chadwick 

36 The End User 

by Arthur Leyenberger 

Ei 40 Database DELPHI 

by Michael A. Banks 

45 Boot Camp 

by Tom Hudson 

80 From Over the 
Big Water 

by Marshal M. Rosenthal 

GJ 107 The Compukid 
Connection 

by D.A. Brumleve 

DO 1 1 2 BASIC Training 

by Clayton Walnum 

\f™\ 39 PD Parade 

by George L. Smyth 

118 Assembly Line 

by Frank Cohen 

121 The ST Macintosh 

by Clayton Walnum 



DEPARTMENTS 



3 Editorial 

by Clayton Walnum 

6 Reader Comment 

1 News Clips 

109 Disk Contents 

110 M/L Editor 

by Clayton Walnum 

128 Footnotes 

by Karl E. Wiegers 
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Where to Write 

Ail submissions should be sent to: ANALOG 

Computing, P.O. Box 1413-M.O., Manchester, Ct 

(16040-1413. All other editorial material (letters, 
press release, etc.) should be sent to: Kditor. 
ANALOG Computing, 9171 Wilshire Blvd., Suite 
300, Beverly Hills, CA 90210. 

Correspondence regarding subscriptions, in- 
cluding problems and changes of address, should 
be sent to: ANALOG Computing, P.O. Box 16927, 
North Hollywood, CA 91615, or call (8 IK) 
760-8988, 

Correspondence concerning a regular column 
should be sent to our editorial address, with the 
name oi" the column included in the address. 

We cannot reply to all letters in these pages, 
so if you would like an answer, please enclose a 
sell-addressed, stamped envelope. 

An incorrectly addressed letter can be delayed 



Advertising Sales 

Address all advertising materials to: 
Paula Thornton — Advertising Production 
ANALOG Computing 

9171 Wilshire Blvd., Suite 300 
Beverly Hills, CA 90210. 

Permissions 

No portion of this magazine may lx- reproduced 
in any form without written permission from the 
publisher. Many programs are copyrighted and 
not public domain. 

Due, however, to many requests from Atari club 
libraries and bulletin-board systems, our new poli- 
cy allows club libraries or individually run BBSs 
to make certain programs from ANALOG 
Computing available during the month printed on 
that issue's cover, for example, software from the 
July issue can be made available July 1. 

This does not apply to programs which specifi- 
cally state tliat they are not public domain and. thus, 
are not for public distribution. 

In addition, any programs used must state that 
they are taken from ANALOG Computing Maga- 
zine. For more information, contact ANALOG 
Computing at (213) 858-7100, ext. 103. 

Subscriptions 

ANALOG Computing, P.O. Box 111927. North 
Hollywood, CA 91015; (818) 760-8983. Payable 
in U.S. funds only. U.S.: $2H-one year, $. r >-l-two 
years, $7(i-threc years, foreign: Add $10 per 
year. For disk subscriptions, see the cards at the 
back of this issue. . . 

Authors 

When submitting articles and programs, bolh 
program listings and text should be provided in 
printed and magnetic form, if possible. Typed or 
printed text copy is mandatory, and should be in 
upper- and lowercase with riuuble spacing, II a sub- 
mission is to be returned, please send a self- 
addressed, stamped envelope. 

for further information, write to ANALOG 
Computing, P.O. Box 1413-MO, Manchester, CT 
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Still #1 

This is a note to thank you for your ex- 
cellent magazine. I have always been 
amazed by the high-quality utilities and ap- 
plications, not to mention the arcade-quality 
games. What is most impressive is your 
continued support of the 8-bit Ataris. I've 
found other magazines losing quality late- 
ly, but yours has certainly kept up its stan- 
dards. I'm sure all 8-bit Atari users thank 
you as I do. 

—Oscar Fowler 
Tucson, AZ 

Reviews, Old Versions 
and Piracy 

I want to give my support for Ian Chad- 
wick's style and tone in reviewing software. 
I agree that Ian is often stern and critical, 
but I have used some of the software he has 
been critical of and I agree with him. At 
least when he says a piece of software is 
good, I know it is. When Ian is critical, he 
gives his reasons and suggests how the soft- 
ware could be improved. If I want to read 
gushing praise, I'll read the back of the box 
the program comes in. 

Furthermore, I want to know why many 
software publishers think that beta-test co- 
pies and old versions of software are good 
enough for Atari users. There may not be 
as many of us, but our money is just as 
green. 

I am also tired of having software piracy 
waved in my face by people like Gilman 
Louie. If the software publishers are so an- 
gry about the pirate BBSs, they should sue 
the SYSOPs. I do not pirate software, and 
I resent being grouped in with those who 
do simply by virtue of the brand of com- 
puter I own. The software publishers have 
every right to be angry, but they should not 
take their anger out on those of us who buy 
the software and keep them in business. 
They should not use threats to fight piracy; 
they should use the law. 

—Travis Capener 
Waterdown, Ontario 
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Show Me You Care 

In "Show Me Your Wares" (July 1989 
Footnotes), Karl Wiegers states that "share- 
ware" is "the best 'ware' word because both 
syllables rhyme." Mr. Wiegers is apparently 
not familiar with the concept of careware. 
Four of my KidProgs are distributed as 
careware; I ask that satisfied users send a 
contribution to an ST-related charity (the 
Leal School ST Fund). I would propose that 
"careware" is a far better "ware" word than 
"shareware": Not only do both syllables 
rhyme, but both syllables also have the very 
same number of letters, and careware con- 
tributions are tax-deductible. 

— D.A. Brumleve 
Urbana, IL 

A Correction . . . 

ST-LOG's COMDEX Report (August 
'89, Issue 35) made mention of PageStream 
PC in a comparison of desktop-publishing 
systems for the IBM PC. Although we are 
certain the authors of PageStream for the 
ST would like to see an IBM version of their 
product, there is no such animal. The re- 
port intended to compare PageMaker PC to 
Calamus. 

. . . And an Apology 

It seems that in our World of Atari show 
report, which appeared in the September 
'89 issue of ST-LOG, we inadvertently left 
out mention of Migraph's attendance, and 
more importantiy, the unveiling of their new 
hand scanner for the ST. We feel that the 
hand scanner is an important product and 
that it should have been included in the re- 
port. Our apologies to Migraph for this 
oversight. 



ST would like to see an IBM version of their 
product, there is no such animal. The re- 
port intended to compare PageMaker PC to 
Calamus. 

The PC Question 

I thoroughly enjoyed the August '89 is- 
sue of ST-LOG and thought I'd make a few 
comments. I liked Todd Threadgill's Foot- 
notes and would like to share my answers 
to Fred's questions. I sell Ataris in a most- 
ly PC store and have been dealing with 
these questions for some time. 

"Can it run Lotus 1-2-31" 

It runs a spreadsheet better than Lo- 
tus. {WW Power, which is faster and has 
a greater capacity.) 

"Can it run WordPerfect 5.0?" 

It runs a superior version of WordPerfect 
that includes windows, drop-down menus 
and point-and-click operation. 

"Can it run Microsoft Word?" 

It runs Microsoft Write, which is the same 
thing. (I just won't mention that it's Version 
1.0 instead of 5.0.) 

What Fred was really asking was wheth- 
er the ST performed PC functions, and the 
answer is a resounding "Yes, and better." 

Finally, applause to Maurice Molyneaux 
for the best explanation of piracy I have ever 
read. From the comparative economies of 
scale to the moral impact on our society, 
he really hit it on the head. 

—John Kolak 
Carmichael, CA 
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C-manship: 

A Complete GEM Application, Part 4 




by Clayton Walnum 

Believe it or not, there are many people 
who prefer to do things the old-fashioned 
way, people who despise such newfangled 
contraptions as menu bars and other mouse- 
driven devices that make them lift their 
chubby fingers from the keyboard. You and 
I, of course, are great fans of GEM, but 
whenever we design a program, we have to 
remember that not everyone shares our 
good taste. Put simply, programs should 
have keyboard alternatives whenever pos- 
sible, especially for selecting functions from 
a menu bar. 

Needless to say, MicroCheck ST pro- 
vides keyboard selection for every function 
in the menu bar. The user who considers 
the ST's mouse a furless rodent unworthy 
of his touch may type a Control-key com- 
bination to select any function he desires. 
This month, we'll be looking at the portion 
of MicroCheck STs source code that han- 
dles the Control-key selections. We'll also 
look at the routines that allow the user to 
begin a new account. 

Compiling 

Listing 1 is this month's portion of the 
MicroCheck ST source code. Add it to the 
combined source code from the previous in- 
stallments, then delete the handle keysQ 

and do newacctQ stubs from the result- 
ing file. 

After compiling the program, you'll find 
that you can now select functions from the 
menu bar by pressing a Control-key com- 
bination. For example, pressing Control-Q 
will exit the program. 

Pressing Control-N, on the other hand, 
will activate the "New" selection of the File 
menu. A dialog box will appear, asking for 
your name, address and account balance, 
after which a second dialog box will ask for 
the filename you wish to use for the ac- 
count. This filename can be up to six 
characters long. When you've typed in the 
filename, MicroCheck ST will save the in- 
formation you typed in the new-account di- 
alog box to a file with an .MCK extension 
and will create all the monthly data files for 
your new account. 

Now let's take a closer look at how all 
this works. 



Function handle keysQ 

If you look at the selections in the menu 
bar, you'll see that each has a single letter 
next to it. This is the key to press along with 
Control in order to select that function from 
the keyboard. But just having the letters on 
the menu isn't enough, of course. We have 
to retrieve the key presses from the key- 
board (which we do by watching for 
MU_KEYBD events with evnt_multi()), 
and when we get a Control-key combina- 
tion, we have to route it to the right por- 
tion of the program. 

This is handled by the function 
handle_keys(), which does much the same 
work as do menuQ, except that we're us- 
ing Control-key values in the switch state- 
ments rather than a menu message. Another 
major difference is that we're using the 
loaded, search and canceling flags to de- 
termine which menu functions are active. 
We didn't have to do this in do menuQ be- 
cause inactive menu selections are grayed- 
out and are not selectable by the user. No- 
tice that in handle keysQ, we are high- 
lighting the appropriate menu title with 

menu tnormalQ, just as we did in 

do menuQ. This tells the user which menu 

he is working with. 

All of the values for the Control-key com- 
binations in handle keysQ are defined at 

the top of the program. (That portion of the 
code was presented in the July '89 install- 
ment of C-manship.) 

Function do newacctQ 

Whenever the "New" selection of the 
File menu is selected or a Control-N is 

typed, the function do newacctQ is called. 

This function brings up the dialog box for 
entering the information needed to start a 
new MicroCheck ST account. 

First, we call clear newacctQ to make 

sure any information that was previously en- 
tered into the dialog is erased. Next, we call 
up the dialog box in the usual way (see the 
C-manship in the May '87 ST-LOG) and ac- 
tivate it with a call to form do(). 

The variable choice will contain the num- 
ber of the object used to exit the dialog. If 
this object is the OK button (NEWOK), we 

call the function check newacctQ to make 

sure all the information in the dialog is filled 
in. If the dialog has empty fields (okay is 



FALSE), we redraw the dialog (the dialog 
is still on the screen, but the buttons haven't 
been redrawn to their deselected state) and 

loop back to form doQ in order to let the 

user try again. 

If the user clicked the OK button and the 
dialog was properly filled in, we call 
newacct_file(), which will get a filename 
from the user for the new account and call 
the functions that will write the new- 
account information out to the disk. 

If the user clicked the cancel button 
(NEWCANCL), we clear the dialog and 
close it, then go back to wait for another 
event. 

Function check newacctQ 

This function simply checks to see that 
none of the fields in the dialog has been left 
empty. We use the flag okay to communi- 
cate this information back to the calling 
function. First, we set okay to TRUE. Then 
we use a for loop to cycle through the edita- 
ble text objects in the dialog, checking that 
none is empty. (An empty field will begin 
with a "@". 

Note that should you ever use this meth- 
od in any of your own programs, the ob- 
jects you're checking must have been 
created sequentially, all at the same time. 
Otherwise, you can't use a. for loop to check 
the objects. If an empty field is found, okay 
is set to FALSE and an alert box warns the 
user that he must complete the form. 

Function newacct_file() 
Most of this function is dedicated to get- 
ting a filename from the user and combin- 
ing it with the right path specification. 

First, we get the address of the string in 
the filename dialog box and clear it with 
a null. (With dialog boxes, you can clear 
a string with the "@" or by the usual null 
character.) Next, we zero out the string file- 
name and call up the dialog box. If the user 
exits the dialog with the OK button (FI- 
LEOK), we call check_fileQ to be certain 
a filename has been entered. If it hasn't, we 
loop back to let the user try again. 

If the user entered the filename proper- 
ly, we retrieve it from the dialog, copy it 

into acct name (a string that will be used 

in the window's title bar), then add the com- 
plete pathname and the .MCK extension. 

(CONTINUED ON PAGE it) 
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GAME REVIEWS 

• ARCADE ACTrO.N 

• STRATEGY GUIDES 
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LH Cui Sign me up for 12 issues for only $19.95— I'll save over $15! 
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Yes! 
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Money back on unused subscriptions if not satisfied! WATCH FOR IT!! 
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MPUTER ADAPTATION OF 



SIMPLE CARD GAME '. 
LPS TO DEVELOP 
"RY SKILLS OF YO"' 
!S. AS AN ENTERTAI. 
, THE PROGRAM PLAYS 
SOUND 
. DIFFERENT PICTURE, 
i DECK OF CARDS IS SHUF- 



FLED AND LAID FACE DOWN ON Sb 

a table. Player 1 turns two 
cards over to reveal their' 5 
FACES. If the pictures on 
THEIR FACES MATCH, PLAYER 1 _ 
REMOVES THE TWO OVER- # 

m 

TURNED CARDS FROM THE TA- 
BLE. Player 1 repeats his P 




turn until he fails to find 
A PAIR, at which time both 



V--: 



cards are turned back over . 
and the turn passes to | 
player 2. Whoever finds |' 
the most matches wins the | 



» 



(CONTINUED ON PAGE 25) 
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New Games From Mindscape 
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Deja Vu II: Lost in Las Vegas 
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Hostage 
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Mindscape, one of the largest producers of 
games for the ST, has several new titles ready 
to go. Deja Vu II: Lost in Las Vegas is the 
latest graphics adventure from the creators 
of Uninvited, Shadowgate and, of course, 
Deja Vu II . In this sequel, the notorious mob- 
ster Tony Malone has threatened you with ce- 
ment shoes if you don't come up with 
$100,000. Lucky for you, Las Vegas is a great 
place to raise large sums of money. . .or is 
it? Like its predecessors, all commands in 
Deja Hi II are entered by clicking the mouse. 
The game is priced at $49.95. 
In Hostage, your six-man strike team must 



HittMi: sj»illi 
tisfs Ati; 



Balance of Power: The 1990 Edition 



rescue hostages from a besieged embassy. 
This arcade-style game has you blasting out 
the embassy's windows, descending by rope 
from the roof and then searching for the 
hostages inside. Suggested retail is $44.95. 
Finally, Chris Crawford's award-winning 
simulation, Balance of Power, gets a revamp- 
ing in Balance of Power: Tlw 1990 Edition. 
In this version, you choose to become the 
president of the United States or the general 
secretary of the U.S.S.R. In either case, it's 
up to you to find the right balance between 
power and diplomacy in order to gain global 
prestige and avoid nuclear holocaust. Ac- 



cording to Mindscape, "Balance of Power: 
The 1990 Edition includes an updated data- 
base covering 1989 to 1997, additional coun- 
tries, an on-screen advisory council to help 
resolve diplomatic crises and a much- 
requested multipolar level, which allows even 
minor countries to make foreign-policy de- 
cisions." Retail price: $49.95. 

Mindscape, Inc. 
3444 Dundee Road 
Northbrook, IL 60062 
(312) 480-7667 

CIRCLE #117 ON READER SERVICE CARD. 
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Educator's Software 

Educational Management Systems has an- 
nounced a series of educator's programs for 
the Atari ST. School Scheduler I is a keyboard 
and mouse data-entry scheduling program 
used to create schedules by sections or by 
teacher. School Scheduler II uses Scantron 
forms that have been filled out by students 
to automatically set up the student's sched- 
ule. The Scantron reader is connected to the 
ST via the RS-232 port, allowing all student 
data to be entered into the computer almost 
instantly. Charles Gauthier, president of 
EMS, says, "Our goal is to get the ST into 
schools. We are working closely with estab- 
lished dealers, giving presentations to local 
school systems to demonstrate this power at 
a price at which there is no competition- 
one that Apple can't compete with because 
the programs aren't available, and one that 
IBM can't compete with because their sys- 
tem is not as fast or as easy to use as our soft- 
ware for the ST." 

The programs are due for release in 1990. 
Prices are not currently available. 

Educational Management Systems 

P.O. Box 153 

Huntington, MD 20639 

(301) 535-0062 

CIRCLE #120 ON READER SERVICE CARD. 

RAM-Disk Utilities 

Helpways has just released RAMPACK, a 
"unified system" of 12 Atari 8-bit utilities. 
The RAMPACK loader automatically installs 
all 12 utilities into your RAM disk at boot- 
up time and then erases itself from memory. 
Any of the utilities may be called up almost 
instantly, including a RAM-resident help 
screen. Because each of the utilities can be 
loaded independently, they do not require a 
RAM disk and maybe run on any Atari 8-bit 
computer. The utilities include, among 
others, MENU, which displays a disk's direc- 
tory; PRNTFILE, which prints a LISTed file 
directly from disk; RAMMAP, which dis- 
plays the current memory limits and free 
RAM; and SCROLLIT, which scrolls pro- 
gram lines both forward and backward. RAM- 
PACK sells for $19.95, plus $2.50 shipping 
and handling. 

Helpways 

P.O. Box H 

Rochester, NY 14623 

(716) 334-2928 

CIRCLE #122 ON READER SERVICE CARD. 



Function-Key 
Template 



game consisting of 80 maze levels from 
which you must escape while avoiding the 
many death icons. All who have tried previ- 
ously have died horrible deaths. 




Regent Software is now shipping Functionz, 
a function-key template maker for the ST. In- 
cluded in the package are six clear-plastic 
label stands and the label-maker program. 
The labels are printed onto ordinary paper 
and then inserted into the stands, which slide 
into the keyboard immediately above the 
function keys. Eight additional plastic label 
stands may be ordered for $13.95 a set. Func- 
tionz is priced at $24.95. 

Regent Software 

P.O. Box 14628 

Long Beach, CA 90803-1208 

(213) 439-9664 

CIRCLE #119 ON READER SERVICE CARD. 



Titus's Titan 




New from Titus Software, producer of Cra- 
zy Cars, Fire and Forget and Off Shore War- 
rior, is Titan, a fast-scrolling strategic puzzle 
game. Professor Hybris. a resident of 
Vegapolis in the year 2114, has created a new 



Anyone brave enough to take on Titan may 
do so for $44.95. 
Titus Software 
20432 Corisco Street 
Chatsworth, CA 91311 
(818) 709-3693 

CIRCLE #121 ON READER SERVICE CARD. 



Print Shop Drivers 

Owners of the 8-bit version of Print Shop 
from Broderbund Software might want to 
check out a series of new printer drivers from 
Innovative Concepts. Drivers are now avail- 
able for the Atari 1020 plotter/printer, the Ep- 
son LQ-500/800 24-pin printers and the 
Okimate 10 color printer. The drivers may be 
used with both Print Shop and the Print Shop 
Companion. These programs do not modify 
your original disks. Each driver is priced at 
$14.95, plus $2.00 shipping and handling. 

Innovative Concepts 
31172 Shawn Drive 
Warren, MI 48093 
(313) 293-0730 

CIRCLE #118 ON READER SERVICE CARD. 



All product announcements to be consid- 
ered for News Clips should be sent to News 
Clips, ANALOG Computing, P.O. Box 
1413-M.O., Manchester, CT 06040-1413. Pho- 
tos, screen shots and product samples should 
be included whenever possible. &, 
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Once the title has been 

loaded, the main program 

can load right over the 

top off it. 






Here is a utility to create a machine- 
language title screen that can be used with 
any binary-load program. When a binary pro- 
gram is appended to the title file, you can bi- 
nary-load the resulting compound file. The 
GRAPHICS title screen will display the 
characters you entered with whatever colors 
you selected while the main program con- 
tinues to load. This method of loading a title 
screen does not require any additional mem- 



by Larry Black 



ory in the main program. Once the title has 
been loaded, the main program can load right 
over the top of it. 

Type in the DATA from Listing 1 using the 
MIL Editor, found elsewhere in this issue, 
saving the file to disk as TITLMAKR.EXE. 
Title Maker is a machine-language program 
written with the MAC/65 assembler, which 
works with just about every DOS configura- 
tion. When binary loaded, it executes auto- 




matically (address $3700). 
The main menu is simple to understand: 
[C] Clear editor memory— Erases the title 
screen from memory and puts you in the edi- 
tor. Be sure you don't hit this before first sav- 
ing your work. There is no warning prompt. 
[E] Editor screen— Switches from the main 
menu to the editor so you can continue edit- 
ing the title screen. Select will return you 
from the editor to main menu again. 
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[L] Load a screen from disk— Normally 
used to load a previously saved title screen 
so you can edit it further. It will also load 
the title from a program that has already been 
appended to the title file. However, do not 
save a screen with the same name as a pro- 
gram file, or it will erase the original pro- 
gram. Keep a backup copy of any program 
you append to a title screen. If the file you 
load is not in the proper binary format used 
by Title Maker, it assumes you are loading 
an ASCII text file and will automatically load 
the first 24 lines, converting the ASCII to 
screen format. Your ASCII text file should 
have an EOL (RETURN character) at the end 
of each line. Each line must be no longer than 
40 bytes, including the EOL. If the file is 
more then 24 lines, you can expect a load of 
the first 24 lines only. The ASCII load rou- 
tine sets the color registers to default (black 
and white). You can then set your desired 
screen colors. 

[S] Save a screen to disk— Saves the title 
screen to disk in a binary-load format. Ac- 
tually, it's a small machine-language program 
along with the screen data that will binary 
load and display the title on your screen. It 
can be reloaded into the editor later, using 
the "L" function, to either change it or fin- 
ish an incomplete screen. The saved file will 
also contain the screen colors you have select- 
ed. In order to keep the screen in view after 
the load has finished, a graphics call must 
either be delayed by your main program, or 
a simple cursor position with a prompt and 
a get-key routine should be used. Of course, 
if your program is long, this method proba- 
bly would not be necessary. 

[1-9] Disk directory— Type the number of 
the desired drive, and the filenames will be 
displayed. Press any key, and you return to 
main menu. 




THE EDITOR SCREEN 

The editor uses 40 columns and all the 
standard Atari editor keys to display 254 of 
the 256 ATASCII characters, just like the BA- 
SIC editor. The return key simply moves the 
cursor to the left column, as usual, but no 



character is displayed. If the cursor is on the 
bottom line, it will return to the top-left cor- 
ner. The screen will not scroll. The clear key 
works the opposite from the BASIC editor. 
Pressing Shift-Clear or Control-Clear will 
only display the ATASCII "arrow" charac- 
ter, and will not clear the screen. This is a 
precaution in case you accidentally hit it 
while trying for a nearby key. To actually 
clear the screen while still in the editor mode, 
just press Escape first, then Shift-Clear. This 
is helpful, should you want to start over and 
retain the same screen colors. If you want to 
clear the screen with default colors, use the 
"C" option from the main menu. 

Using the GRAPHICS Atari character 
set, create the desired title screen. You will 
notice that when you print a character in the 
bottom-right corner of the screen, the charac- 
ter is printed and the cursor jumps to the top- 
left of the screen, rather than scrolling the 
entire screen. You can save your work from 
time to time by pressing the start key from 
the editor screen or with the "S" option from 
the main menu. 

THE HELP MENU 

Control-arrow key: responds for cursor 
placement, just like the BASIC editor. 

Shift-Control/up-down arrows: changes the 
screen color register. You can cycle back and 
forth through all 128 colors. 

Shift-Control < or > : changes the screen 
border colors. 

Shift-Control-0 or -P: changes the text lu- 
minance. If you should happen to find a blank 
screen after loading a file, try changing the 
text luminance to read the screen. It might 
have been set to the same value as the screen 
color, hiding the text from view. 

Option: displays the help menu. Press any 
key to return to editor. 

Select: returns to the main menu from 
editor. 

Start: returns to the main menu and sets 
up for a binary save of the screen. 

HOW THE TITLE SCREEN 
WORKS 

Using DOS, copy with /Append the binary 
program to the title file. For example, let's 
say your title file is TITLE.EXE, and the bi- 
nary program is DATABASE.EXE. With a 
backup copy of each on the same disk (Drive 
1), and using Atari DOS, type the following: 

C [RETURN] 

DATABASE . EXE, TITLE . EXE/A [RETURN! 

The DATABASE.EXE program will be ap- 
pended to the TITLE.EXE program. Then 
delete the backup copy of DATABASE.EXE 



and rename the TITLE.EXE to DATA- 
BASE.EXE. The new program will be about 
eight single-density sectors longer than the 
original. 

When you binary-load the new compound 
program, the title screen will load and dis- 
play, and the main program will automatically 
load and execute. For best display purposes, 
your main program should display a "Press 
Any Key" type of prompt on the screen be- 
fore clearing the title. Then it should look for 
a keypress before making a graphics call. A 
good example of this is the Title Maker pro- 
gram itself. Watch the screen as it loads. You 
can even load the title screen from the pro- 
gram itself, as a sample. 

BASIC programmers who would like to use 
the Title Maker, don't fret. There is a way you 
too can use this utility for BASIC 
AUTORUN-type files. Listing 2 is a small 
but efficient means for you to do so. To ac- 
cess this method, type in the TIT- 
LMAKR.BAS program (Listing 2), using 
BASIC Editor II to verify your work. Once 
you have done this, save it to disk for back- 
up use. Now run the BASIC program. What 
it does is create a binary file (AU- 
TOBOOTTM) that you can append to any of 
your Title Maker screen files to be used with 
a saved BASIC program. Once you do this 
and have appended the AUTOBOOT.TM file, 
rename it to AUTORUN.SYS and rename 
your BASIC program to AUTORUN.BAS. 
Next time you reboot that disk, it will load 
your title screen and automatically run the 
AUTORUN.BAS program. 

For an added touch of show, here is a neat 
trick you might want to try. Make several 
screen files and append them all together. 
When you binary-load a compound screen 
file, each screen will be displayed, one at a 
time, in the order they were appended to the 
main file. 

CONCLUSION 

Using Title Maker, you can make your pro- 
grams look as professional as the commer- 
cial ones. Try it. I know you'll be pleased 
with the results. e\ 

LISTINGS 

CONTINUED ON PAGE 86 




Larry Black got his first computer, an 
Atari 400, six years ago and now hopes for 
a career in computers. Title Maker is his first 
published program. 
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PAGESTREAM GETS SERIOUS 



by Donovan Vicha 

Last month I described a book project I 
put together using the Migraph "Art Depart- 
ment" (Easy Draw and Touch Up). This 
month I will continue the story, concentrat- 
ing on SoftLogik's PageStream. But first, 
let's look at what's involved in the editorial 
production of a book. 

Once an author submits his manuscript 
to a publisher and it's accepted, it's no 
longer his or her labor alone that puts the 
finished book on the shelves of a B. Dal- 
ton or Waldenbooks store. The manuscript 
goes from the acquisitions editor to a pro- 
ject editor (there are other titles used: con- 
tent editor, associate editor), whose 
responsibilities include fact checking, evalu- 
ation of contents for consistency and com- 
prehensiveness (as well as comprehension!) 
and ascertaining whether all illustrative ma- 
terial (photos, charts, graphs, line art, etc.) 
is included and properly keyed to its place 
in the manuscript. 

Once this editor has completed his or her 
work, the manuscript is copyedited. The 
copy editor ensures that the manuscript is 
grammatically correct, that captions for il- 
lustrations are correct and appropriate, and 
that the author's style remains consistent. 
The copyedited manuscript then goes for 
design, either by a book designer or the 
production editor. 

The production editor (PE) is given the 
responsibility to oversee the manuscript 
through the rest of the publication process. 
Usually, the first-pass galleys (the typeset 
manuscript) are read by a proofreader and 
the PE to catch typos and dropped 
words/lines/paragraphs/etc. , and to see that 
all the type specifications have been correct- 
ly carried out. The author also sees this set 
of galleys to make any changes, which the 
PE is obliged to transfer to the proofread 
set that goes back to the typesetter. Second- 
pass galleys are also proofed, but another 
set is given to a layout artist who creates 
a dummy of the book. (As a production edi- 
tor myself, I have often been the layout art- 
ist as well.) 



The dummy shows, page by page, where 
text and graphics go, usually in two-page 
spreads. All elements of the book are ac- 
counted for here: running heads (or foot- 
ers), part and chapter openers, front matter 
(copyright, title pages, contents, dedica- 
tions, epigraphs and so forth), back matter 
(glossaries, appendices, index), and the 
body of the book (text and graphics). The 
PE goes over the dummy to ensure that it 
has been handled correctly, as does the ac- 
quiring editor or the project editor. The PE 

You might begin to 

wonder about those 

Macintosh ads where 

the senior executive, 

holding the complex 

book in his hand, 

looks askance at the 

dimpled Mac user who 

claims to have done 

it all himself. 

also keys patches to the dummy pages- 
patches being the corrected portions of re- 
vised (second-pass) galleys caught by the 
second go-round of proofreading. (Instead 
of rerunning a third complete set of galleys, 
corrections are made only of the offending 
line or lines and then pasted over the incor- 
rect passage.) 

Once the dummy has been approved, the 
layout goes to a keyline artist who does the 
actual paste-up of the camera-ready type 
and other elements, if any, on "boards." 
These boards are generally of a lighter 
weight than run-of-the-mill cardboard and 
are preprinted with blue lines, which are in- 
visible to the camera used by printers, to 
create the plates used to print the pages of 
the book. These blue lines indicate where 
text should go and where running heads and 
folios should go, making the keyliner's task 



much simpler. In some cases, these boards 
are printed with black ink for elements that 
are supposed to be captured on the (nega- 
tive) plate and printed. 

The printer usually provides the publisher 
with a trial printing of the book, usually 
called a "blueline" due to the blue ink used 
in its creation. Depending on the kind of 
press used, these pages are grouped in "sig- 
natures" of 12, 16 or 32 pages of very cheap, 
slick paper, which I've always found hard 
to write on except with a grease pencil. The 
PE must check every page for instances of 
broken type or blobs of ink, note that pho- 
tos and graphics are cropped and positioned 
correctly and watch for irregularities in 
print quality of text and graphics. Oh, yes, 
they must also verify pagination (make sure 
the pages are in the correct order). 

As you can see, a complicated process 
and a team effort lies behind the produc- 
tion of any book you purchase. A similar 
process occurs for most publications, but 
because newspapers and magazines gener- 
ally follow the same format, the process is 
simplified. The deadlines for newspapers 
and magazines are stricter and shorter, 
necessitating the simplified process, but 
certainly not making the job for the produc- 
tion editor any easier. 

If you've followed this cursory explana- 
tion of the publication process and under- 
stand desktop publishing, you might begin 
to wonder about those Macintosh ads where 
the senior executive, holding the complex 
book in his hand, looks askance at the dim- 
pled Mac user who claims to have done it 
all himself. The exec is right: No way! I 
hate to report it, but a week just doesn't have 
enough hours, folks, unless Mr. MacDim- 
ple doesn't eat and sleep, and unless his 
Mac is equipped with a time machine. 

It's unlikely a laser printer— especially 
the much-vaunted Lino 300— is going to 
give you several hundred text pages (let 
alone text and graphics) in less than two or 
three days. That leaves four days for writ- 

(CONTINUCD ON PAGE 22J 
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THE BASIC 

UTILITIES 

PACKAGE 



by Barry Kolbe 

With the BASIC Utilities Package, you 
can program in BASIC and still access the 
disk functions like: directory, locking files, 
deleting files. Normally, to do these func- 
tions you would have to save your program, 
type DOS and wait until DUP.SYS loaded 
in. Then it was back to BASIC, reload your 
program, etc. With BUR SYS you merely 
type "DIR" for a disk directory. That's all 
there is to it. Your program remains intact. 
And that's not all. You also get automatic 
line numbering and renumbering, not to 
mention decimal and hex conversions at 
your fingertips. And there's more! List the 
variables in your program and their line 
numbers, and trace your program while it 
is running. 

Typing it in 

BUR SYS is a machine-language program 
and must be typed in using the M/L Edi- 
tor, found elsewhere in this issue. Listing 
1 is the data that will create your copy of 
the BASIC Utilities Package. You should 
type it using the M/L Editor, found else- 
where in this issue, and name the resulting 
file AUTORUN.SYS. 

Loading BUP.SYS 

The BASIC Utilities Package will load au- 
tomatically when you boot your computer 
with a disk containing DOS and the AU- 
TORUN.SYS file you created from Listing 
1. The message "BASIC Utilities Package" 
will appear, followed by the BASIC prompt 
"READY." BUP.SYS remains in memory 
until you type DOS or turn the computer 
off. 

BUP.SYS Commands 

BUP.SYS supports 13 commands, shown 
in format form below: 



REN 


tnnnn, 


nnnnl 


HUM 


tnnnn, 


nnnm 


TRA 






OFF 






DEC 


itnnn 


;::■:■: : ■ ] : 


HEX 


[Sinnnn 


LVA 






DOS 







DIR 








PRO 


"D 


f ilespec .ext 




UNP 


"D 


f ilespec .ext 




NAM 


"D 


f ilespecl.ext, f 


ilespec2 ext 


ERA 


"D 


f ilespec .ext 













All commands are three letters in length, 
with no spaces allowed in the first three let- 
ters. After the first three letters, spaces are 
removed. For example, HEX $ AO 00 is 
crunched down to HEX$A0000. 

DIR gives a listing of the disk directory. 

PRO, UNP, NAM and ERA are file- 
management commands. They lock (pro- 
tect), unlock (unprotect), rename and erase 
files on disk. Think carefully before using 
ERA— you are not asked if you are sure! 
Once you hit Return, your file is erased. 

REN is the renumber command. The first 
number following REN is the new starting 
line number and the second is the increment 
between lines. For example, REN 100,10 
makes the first program Line 100, the next 
110, the next 120 and so on. More on REN 
later. Typing REN [Return] gives default 
values of 10 and 10. 

NUM is the auto line-numbering com- 
mand. As in REN, the first number is the 
first line number and the second is the 
increment between lines. The default values 
are 10 and 10 if you type NUM [Return]. 
If a program is in memory, NUM [Return] 
will start numbering at the last line (plus 
the increment, of course). To stop auto line- 
numbering, hit the break key. Do not press 
Reset! Disastrous things may happen if you 
do. 

NUM will not allow you to type over an 
already existing line. For example, if Line 
100 exists and you type NUM 100,10, no 
auto line-numbering will be done. No mes- 
sage appears, just the READY prompt. 
Even while NUM is in operation, it will 
quit if you are about to type over an exist- 
ing line. 

TRA allows you to trace a BASIC pro- 
gram. When you type TRA [Return] an ex- 



tra display line is set up above the normal 
screen. The message "EXECUTING 
LINE: 032768" is displayed on this line. 
When you run a BASIC program, this mes- 
sage is updated 60 times a second during 
the vertical blank. Consequently, it may be 
a blur at times. Infinite loops are easy to 
spot. Trace works in any graphics mode. It 
will stay in effect until you remove it by typ- 
ing OFF [Return]. Trace uses the immedi- 
ate vertical blank interrupt, so don't use 
Trace if your program also uses that inter- 
rupt vector. 

OFF turns off the Trace function and re- 
moves the extra display line. I would recom- 
mend turning it off before performing disk 
commands. Whenever BUP.SYS uses the 
disk drive, it automatically turns TRACE 
off. 

DEC converts any decimal number from 
to 65535 to its hex equivalent. If you type 
in anything other than a whole number in 
this range, the result should not be trusted. 

HEX converts any four-digit hex number 
to its decimal equivalent. A "$" is option- 
al. For example: HEXA000 and HEX$A000 
are both acceptable. 

LVA lists the variables in your BASIC 
program and the line numbers in which they 
appear. 

Now that we've covered the basic com- 
mands, we must turn our attention back to 
renumber. 

REN, in addition to renumbering the pro- 
gram lines, renumbers internal line refer- 
ences. There are nine program statements 
that can use line numbers. They and their 
BASIC tokens are: 

Statement Token 



LIST 


4 




GOTO 


10 




GO TO 


11 




GOSUB 


12 




TRAP 


13 




RESTORE 


35 




IF(THEN) 


7(. 


.27) 



ON(GOTO) 30(...23) 
ON(GOSUB) 30(...24) 
De Re Atari has a nice explanation of 
tokenized BASIC. ANALOG issues 25 and 
26 also have articles on this subject. Each 
statement can be followed by a line num- 
bers), variable(s) or algebraic expres- 
sion^). For example: 



1) GOTO 1050 

21 LIST 1040,1108 

3J GOSUB N4 

4J RESTORE 240+U 

5J TRAP 15*P 

6) ON Z GOSUB 28,N,25,6*T,30 

?J ON T GOTO 1808,1108,1200,1380 
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The numbers or expressions following the 
statements are internal line references; REN 
cannot decipher all of these. REN will only 
renumber an internal line reference if it is 
an actual number. Only in examples 1, 2 
and 7 would all internal lines be renum- 
bered. The others would cause a message 
to be sent to the screen. 

The three conditions and their messages 
are shown in Table 1. 



CONDITION 



MESSAGE 



1. A renumbered line Line >= 32768. 
would be > =32768. 

No renumbering done. 

2. An internal line NF-100 
number cannot be 

found. It is not 
renumbered. 

3. An internal line VR-540 
reference is a variable 

or contains a variable. 
Table 1 

To remedy the first condition, choose a 
smaller first line number and/or a smaller 
increment. The second condition means 
that you are missing a program line. For ex- 
ample, Line 100 might be "100 GOTO 
2000" when Line 2000 doesn't exist. 

The last type is the most frustrating to 
deal with. Examples 3, 4, 5 and 6 from 
above would result in a VR-line number 
message. Whenever REN encounters one 
of those special nine tokens, it checks 
whether it is followed by a line number. If 
it is a line number, that line number is 
renumbered. If not, a VR message is given. 

If a list of line numbers, separated by 
commas, is possible (types 2, 6 and 7), 
these are renumbered until a variable is en- 
countered. If a variable is found, all renum- 
bering on that statement is halted and the 
next statement on the line or the next line 
is checked for one of the nine tokens. 
Again, the VR message would be sent to 
the screen. In example 6, the 20 would be 
renumbered, but no others, not even the 25 
or 30. 

A TRAP statement with a line greater 
than 32767 would also give an NF message, 
but this type of TRAP is used to shut off 
a previous TRAP and so doesn't need to be 
renumbered. 

If LIST is not followed by a line number, 
it is listed as a VR. This doesn't represent 
a problem. 

Except for the exceptions just noted, all 
lines printed on the screen with either NF 
or VR need to be examined and any neces- 
sary changes made. Save a copy of the un- 



renumbered program in case you need to 
check line numbers. 

The message "Program renumbered" is 
displayed on the screen when the process 
is complete. It should not take more than 
a few seconds. 

Anomalies 

Some unusual things have happened to 
me while using BUR SYS. An IF-THEN 
statement, such as "20 IF I$='R' THEN 
POPiGOTO 240" resulted in a VR-20 mes- 
sage when I renumbered it. Even though 
Line 240 existed, the message VR ( NF) was 
sent to the screen. I'll try to explain why. 
In tokenized BASIC, following the token for 
THEN is a number (zero-255), which gives 
the offset to the next statement on the line. 
REN checks the token after the THEN to- 
ken to see whether it is a line number. The 
token for a number is 14. Guess what the 
offset to the next statement is in Line 20. 
Yes, it is 14! The same as the token for a 
number. Since POP is not a number, the VR 
message was printed. 

Originally, I used UNL as the command 
to UNLOCK files. I changed it to UNP so 
it is more like DOS XL. One Saturday my 
son, Philip, was trying out BUPSYS. Need- 
less to say, he was impressed! Then Phil 
decided to work with Clayton Walnum's 
programs from "Adventurous Program- 
ming." He got to the point where he was 
to "UNLOCK DOOR." The screen looked 
like this: 



WHAT NOH? UNLOCK DOOR 

ERROR tt 146 

READY 

WHAT HOW? 



Remember that BUPSYS parses (scans) 
all inputs before passing them on to BASIC. 
BUPSYS thought he was trying to UN- 
LOCK a file! We changed the verb to KEY 
to make the program work with BUPSYS. 
It was also interesting to watch the program 
work with the TRACE function. 

Technical Notes 

BUPSYS is a BASIC Utilities Package, 
so the BASIC cartridge must be present to 
use it. BUPSYS loads at $2000 and moves 
LOMEM to $2AFB, using 2,811 bytes of 
memory. After loading, BUPSYS clears the 
stack and jumps to the BASIC cartridge. If 
BASIC is not there, there will certainly be 
a lockup. In the initialization process, it 
wedges itself into the editor's Get-Byte rou- 
tine. By doing this, an immediate-mode 
command is scanned by BUPSYS before 
sending it to BASIC. In this way, BUPSYS 
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can take control if the command is one it 
recognizes. The Put-Byte routine is used to 
print messages on the screen. 

BUPSYS works fine with DOS 2.0 and 
2.5, but has serious problems with DOS XL 
and perhaps others. Two vertical blanks are 
used. One is for the TRACE command. The 
other is used by auto line-numbering. 
BUPSYS is "protected" from Reset to pre- 
vent its erasure. But if I were you, I would 
not press Reset while using auto number- 
ing, renumber or TRACE. I shudder to 
think of a program that is partially renum- 
bered. Any other time, pressing Reset 
should present no difficulty. If you do get 
stuck, typing X=USR(8192) will probably 
fix things by reinitializing BUPSYS. 

Conclusion 

I think you'll agree that a program like 
BUPSYS has been needed for some time. 
I hope it will make your programming 
easier, ei 




Barry Kolbe is part of the BBK program- 
ming team, which is responsible for such 
ANALOG programs as The BBK Artist, 
The BBK Monitor and The ANALOG 
Database. He is a teacher in Wisconsin. 
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Public Domain Software 



#57 - Tease Me Adult Animation (Color Only) 

#393/394/533 • PrintMaster Graphics 

#400 - 7 Disk Labeling Programs (w/100 Labels $6.95) 

#443 - Intersect RAM Baby (RAM Disk/Print Spooler) 

#475 - Werty's House of Horror (Adult Game, Color) 

#500/600 - Publishing Partner Fonts 

#511 - Dungeon Master Maps for Levels 1-7 

#512 - Dungeon Master Hints/Character 

#555 - The Assistant Chef - Electronic Cookbook 

#557 - Children's Programs (Color Only) 

#567/728 - Accessories 

#575 - Sheet V2.0 - Shareware Spreadsheet 

#588 - Pac Man, Hangman and 5 others (Color Only) 

#599 - PageStream Fonts, Font Converter 

#655 - ST Writer V3.0 w/Spell V2.8 

#690 - Opus V2.10 GEM Spreadsheet (1 Meg/DBL) 



Introductory Offer - Above Disks Just 

$2.99 Each 



ST Xformer Cable $19.95 

Run 8 Bit programs on your ST! Use 5 1/4" or 3 1/2" 
Disks. Loads & Runs protected disks. Receive the 
latest version of ST Xformer FREE with purchase of 
cable when you mention this ad. 



Call or Write for FREE Catalog 
(800) 347-6760 



BRE Software Dept. STL 
352 W. Bedford, Suite 104 
Fresno, CA 93711 

Customer Service (209) 432-3072 
Shipping $2.50 Ground / $4.00 2nd Day Air 
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Europe is known for culture, and since 
we all love culture, what could be better 
than going to England to explore many cen- 
turies' worth of history and art? I can think 
of only one thing: an Atari ST show just 
outside of London, in the Alexandria Pal- 
ace Conventional Hall. 

The first thing I noticed was the crowd 
waiting to get in, something we're not used 
to seeing in the States (the ST is doing well 
overseas). Inside the show there were many 
young people— some as young as ten years 
old— dragging their "mums" from booth to 
booth. Many adults were in attendance too. 
And, of course, vendors everywhere were 
selling software and hardware. 

Atari Innovation Award 

Immediately apparent was a complex just 
inside the entrance where a number of ex- 
hibitors were showing their entries in the 
Atari Innovation Award Contest. The pur- 
pose of the contest was to show how an ST 
can be used in new and innovative ways. 
One exhibitor in particular caught my eye: 
David Jones and his Comfortable Wheel de- 



sign. This award-winning invention (it took 
second place) is a resilient wheel with a 
built-in suspension system. The wheel is 
ideal for wheelchairs, as it "pushes" up and 
over obstructions. Jones bypassed the neces- 
sity of producing handmade models of the 
wheel by using his ST. Because the design 
program is written using FastBasic, changes 
in the design can be easily implemented, 
with the computer drawing and animating 
the result. 

Hardware 

Another product that attracted my atten- 
tion was the Hawk Colibri hand-held scan- 
ner, which will read graphics as large as 
half a standard page and convert them into 
32 gray levels. The unit plugs into the ST's 
cartridge port and can adjust the level of 
scanning to 100, 200, 300 and 400 dots per 
inch (dpi). The scanner includes sophisti- 
cated software with zooming capabilities, 
and a Tools and Options menu. Images are 
saved in DEGAS, .IMG and .GEM formats, 
with many laser and dot-matrix printers 
supported. Optical Character Recognition 
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(OCR) can be purchased in ROM, allow- 
ing the unit to translate text into ASCII 
characters at a speed of about 50 charac- 
ters a second. 

When it comes to a monitor, big is always 
better. Signa's Matscreen MHO is a fat, 
19-inch paper- white monitor with a bright, 
non-interlaced screen that has a 1,280 x 
960 resolution. The controller board fits 
into the processor bus of a Mega unit and 
will work unmodified, provided the appli- 
cation being used was written according to 
GEM rules (some examples of programs 
that work with the monitor are Fleet Street 
Publisher, Timeworks Desktop Publisher, 
1st Word Plus vl.12 and Gem Draw). This 
monitor is expensive, however (£1,750, near- 
ly $3,000.00), but seeing is believing. 

How often have you heard the old saw, 
"Everybody talks about the weather, but no- 
body ever does anything about it"? Well, 
here's your chance to get a jump on the 
weather. Meteosat (Signa Publishing) turns 
your ST into a weather receiving station that 
picks up images from the Meteosat and 
GOES satellites. The images are initially 
processed in West Germany, where land- 
mass outlines are added, along with the 
Whole Earth image being split into 11 dis- 
tinct subimages. These are then re- 
transmitted to satellite and can then be 
picked up by your STVwhiph can save and 
animate 11 images at a time. 

Not exactly your typical weekend project, 
the entire system can be up and running in 
a few hours. Hardware consists of a satel- 
lite dish, pre-amp, receiver and de- 
modulator, The software enables infrared, 

isible light and cloud-vapor images of Eu- 

pe and the U.S. Any ST will do the trick. 

ovided there's a double-sided drive and 
of monitor. 

Part of the fun of these shows is trying 
o find the hot products "buried" amidst the 

ore ordinary displays. I was attracted to 

ine of these "gems" by a small television 

perimposing titles over scenes from Mi- 
i Vice. I could see a small black box, 
slightly larger than a hardcovei book, at- 
tached to an ST and a VCR under the ta- 
ble. I managed to get director Jeremy Rihll 
of Digita to pull it out for a closer look. 

"Our MultigCn genlock is designed to 
work with either PAL or NTSC [U.S. stan- 
dard] systems automatically," he says. "You- 

an also see that it's been designed to run 
off a nine-volt battery rather than AC." Us| 
ing custom chips designed in the States, the 
genlock attaches to the ST's RGB port, with 
a pass-through for the monitor. Multigen 
uses standard BNC plugs and outputs to 
RGB or RF. Digita expects to retail it in the 




£500-£600 range (around 1,000 U.S. dol- 
lars) and is discussing a more professional 
unit that will take advantage of the 400 lines 
of resolution possible with the Super VHS 
system. 

In another corner could be found more 
monitors, this time displaying images of the 
crowd. These images were manipulated by 
VIDI ST, a real-time digitizer that can grab 
an image from a moving video in l/50th of 
a second in a full 16 shades. 

VIDI ST's software includes many power- 
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ful tools, such as full palette control over 
each frame and eight levels of controllable 
brightness. Frame registration is accessible 
through an interrupt feature (interrupt live 
frames with existing frame), and the inter- 
face uses drop-down menus and single-key 
shortcuts^. Cut and Paste is fully supported 
as well. The device plugs into the expan- 
sion port and works with both PAL and 
NTSC: images. Frame sequences can be 
stored into memory faster than 12 per sec- 
ond, and animation can be displayed at up 
to 25 frafnes per second. 

Now we come to one of those products 
that sound too good to be true. The ParSec 
graphic interface is a hardware device that 
plugs into the Atari ST without modifica- 
tion and turns it into a super graphics ma- 
chine: Resolution with a non-interlaced 
monitor reaches up to 1,024 X 768 (low be- 
ing 640 x 480). You want colors? Try han- 
dling 16 per line, 4,096 per screen, using 
'four-color planes. Utilizing a 32-bit 
50-MHz processor with memory capabili- 
ties up to 5.5 megabytes, ParSec is about 
the size of a 1040ST and has video, RS232 
and SCSI (for connecting CD ROMs, vid- 
eo and hard-disk drives) connectors. 

A full -featured art package is supplied, 
which supports pixel processing and con- 
ventional drawing/manipulation features as 
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expected. A professional artist package is 
being designed to include chalk, oil and wa- 
ter emulation, plus support for ray tracing 
and animation. (Designs are under way to 
upgrade this package further.) Most conven- 
tional programs can be modified using a 
GEM-to-ParSec converter program so that 
they can run in conjunction with the Par- 
Sec and realize the advantages of superior 
resolution and color palette, plus high-speed 
operation. Add-ons will include a gen- 
lock/digitizer for external mixing and over- 
laying of video signals and the input and 
manipulation of stored images. All of the 
above can be had for a retail price of ap- 
proximately $1,550.00. 

Frontier Software is known mainly as an 
importer of Supra products, but they've got 
a new line of their own hardware as well. 
Their disk duplicator is just the thing for the 
small software house, as it enables duplica- 
tion of up to 32 disks per minute. The inter- 
face board plugs into the disk drive of the ST 
and has ports for drives in both 3 l /2-inch and 
514- inch formats. Frontier's Forget-Me- 
Clock II plugs into the cartridge port and has 
a pass-through for additional uses. 

Games 

Before I had a chance to look at the many 
game booths, Mungo Leir of Software Ho- 
rizon grabbed me by the shoulder, pulled 
me over to a corner (what happened to the 
restrained British character?) and started 
pulling out boxes containing Software 
Horizon's new budget line of software. 

"Games have a definite life," Leir says. 
"They must keep in step with the expecta- 
tions of the player and give value based on 
their price. We have new titles that are both 
original and inexpensive." 

First up is Twylyte, a 3-D fighting simu- 
lation that owes much to the Star Wars coin- 
op. Triton 3 is a vertically scrolling shoot- 
'em-up with a space theme, while Stomp 
(great title) turns the ST into a drum ma- 
chine with 60 editing tracks. Metropolis is 
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an arcade/adventure game using an over- 
head 2-D view. 

Interceptor Ltd. showed their upcoming 
new title, Outland, to be released on their 
Pandora Software label. Giving the player 
near-arcade quality, it features two-plane 
full-parallax scrolling, a 380K digitized 
sound track and a 380K animated end se- 
quence. The aliens may have come in peace, 
but once Earth accepted them. . .dog meat 
time! Now it's up to those Earthlings left 
on Titan to plan their revenge. 

Anco's soccer simulation, Kick Off, is one 
of the fastest-moving games we've ever seen 
on the ST. It's traditional European soccer, 
coupled with a U.S. tournament. Even if 
you don't care one whit for soccer, you'll 
want to see it just for the speed. An over- 
head view presents both teams, with a map 
in the upper-left corner that shows an over- 
view (the screen scrolls vertically). Sound 
effects are excellent, but it's the animation 
that really takes the cake here, making for 
a fast-paced game of highly addictive qual- 
ity. The goalies are computer-controlled at 
all times, and they slide and jump all over 
as the ball approaches them. Control of the 
team is handled with the joystick and fire 
button, and takes some getting used to. 

Other Stuff 

Hat Software addressed the young peo- 
ple's market with First Paint and First Type. 
Each is easy to use, and Paint contains 
many of the standard drawing features, such 
as fill, lines and circles. Type helps children 
learn to use the keyboard and Jigspell en- 
courages word recognition through text and 
pictures. 

For a wider audience, there's Blow Up, 
which enlarges images for printing, and 
Colour Strip, a color-separation and 
sequence-dump utility. Sprinter is a pack- 
age that helps in the designing of patterns 
for silkscreen printing. It also handles col- 
or separations and includes drawing tools. 
That 's Fun Face is a hoot. Designed in Hol- 
land, Face lets you create your own "peo- 
ple" by using the parts supplied. Parts can 
be shifted left, right, up, down, inwards and 
outwards. A paint menu allows for airbrush- 
ing, bas-relief and text insertion. Five 
screens can be held in memory at one time, 
and images can be saved/loaded in formats 
that include .IMG, .PIx, .RGH, .CLP and 
.ICN. Most interesting is that printing can 
be done with the included Postscript driv- 
er, as well as with the expected dot-matrix. 

At the End of the Day 

The show was winding down for the day 
when I heard an exhibitor mutter, "Two 




Marshall Rosenthal and Jeff Minter 



more days of this?" As for me, I was off 
to see the new James Bond film at Leicester 
Square, fl 



Marshal M. Rosenthal has been involved 
as a photographer and writer in the over- 
seas market since the early days of Atari. 
His features and pictorials can be found in 
major computer- and entertainment-related 
publications throughout England, France, 
Germany, Sweden, Mexico and the U.S. 

Products mentioned: CONTINUED ON PAGE 33 
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ing, editing, compiling notes, creating 
graphics and laying out the material. (And 
assumes no corrections are needed.) Also, 
most corporations require a multitude of ex- 
ecutives to make their own additions and 
subtractions, as do book editors. 

Personal Publishing magazine ran an ex- 
cellent article in their August 1989 issue 
debunking eight desktop myths. (I highly 
recommend this magazine to anyone seri- 
ously using their ST for desktop publish- 
ing despite its minimal attention to our 
favorite computer.) One of the myths missed 
by the writer was the printing speed myth: 
a laser printer is not faster than a dedicat- 
ed typesetting printer. And sending a large 
document out to a Lino service can be al- 
most as slow as sending a manuscript to a 
typesetting service. It is also just as ex- 
pensive. 

That was the rub when I worked on an 
experiment with a major Chicago publish- 
er to produce a book on The Munsters TV 
series. I had the tools, but we didn't have 
the budget to carry it out. However, the fact 
that we didn't follow through does not mean 
that DTP isn't ready for the world of book 
publishing. It just isn't ready to take over 
the entire process. I have several friends 
who use their computers to create dummies 
of textbooks from which the publisher then 
typesets— virtually recreates from 
scratch— the final version of the book. Text- 
book publishers have the money (and time) 
to do this; but slowly, trade-book publish- 
ers are beginning to jump into the DTP are- 
na as well. 

Enter PageSffream 

The sample pages included with this 
column were created using PageStream and 
were employed to guide the design of the 
Munsters book we talked about last month. 
(The book should be now available at a 
bookstore near you.) I used PageStream be- 
cause of its ability to wrap text around ir- 
regular objects. 

Also included in the figures is a page 
from the working dummy of the book to 
give you a rough idea of how the typeset 
book would turn out. Scans of photos were 
created using PictaScan (E. Arthur Brown) 
and ST Scan (Navarone), but were for po- 
sition only, meaning that the printer would 
use the actual photo for creating a halftone 
picture. 

Another reason for using PageStream was 
that I am very familiar with it. 

I am indebted to beta-tester Bill Rehbock 
and SoftLogik's Mark Wetzel for use of beta 



copies of PageStream (1.55b and, most 
notably, 1.57b), which vastly improve upon 
the performance of 1.5. By now, Version 1.6 
is available, and anyone who has been hang- 
ing on since the horrendous beta release of 
1.0 knows that, at last, PageStream is a seri- 
ous, state-of-the-art publishing program. 

To me, the most significant improvement 
has been the solidification of tagging oper- 
ations, although most people will find the 
speed of its loading and redrawing increased 
remarkably over 1.5. Since its first appear- 
ance as Publishing Partner, right through 
to the PageStream 1.5 release, the most an- 
noying aspect of Deron Kazmaier's labor of 
love has been the arbitrary way in which 
"default" font styles were handled. If you 
had used 60-point Palatino in a previous 
session, it would likely be the default for 
the next dozen sessions. Loading in text 
would be a nightmare, if not next to impos- 
sible, if your text area was too small. And 
having to reset the text to the font you real- 
ly wanted in the first place seemed a fool- 
ish waste of time and energy. Furthermore, 
inserting text was also a horrendous task be- 
cause it never matched the style into which 
it was inserted. 

With PageStream 1.6 you can now select 
a tag before importing text and get just what 
you want. Granted, the Ventura-like tagging 
ability of Timeworks Desktop Publisher 
(TDP) is easier to work with, but Page- 
Stream allows more options to be selected. 
Desktop Publisher lacks many of the one- 
shot typestyle options that PageStream 
offers, so it gives with one hand while it 
takes away with the other. The main point 
is that, to master PageStream, you must 
master its tagging capabilities and learn to 
live with its present limitations. 

Setting Up a Template 

Thus, once you've set the document size 
(by choosing New Document under the File 
menu), your next step in using PageStream 
should be to create tags. These tags can be 
modified later, but first begin with the "de- 
fault" tag, which is usually the first tag you 
create. Name the tag, then go down the list 
of options. Unless you are getting creative 
and know what you are doing, leave the Fill 
and Color options at the bottom of the list 
alone. I cannot begin to relate the anguish 
and frustration that dogged me once I'd set 
a white fill to print black and saw nothing 
printed despite what appeared correct on 
screen. You cannot go back to an uncom- 
mitted Fill or Color choice. 

Let's look at what I had to do after I creat- 
ed a new document for my Munsters sam- 



ple. In the copyediting process, 16 distinct 
text treatments were identified. Along with 
the usual chapter titles, heads and subheads 
and body-text styles, there were several 
kinds of sidebars indicated, each requiring 
a head. This did not mean I had to use 16 
different typefaces or sizes. Generally, good 
design sticks to one or two font families, 
so the rest of the distinctions are broken 
down into using bold and italic styles and 
changing sizes and the measure of a line of 
type (or how it is indented). 

I also had to consider how photographs 
would be treated. This is where I took my 
lead for handling the design of the book. 
A majority of the photos were on two kinds 
of contact sheets (film strips exposed on 8 " 
x 10" sheets of photo paper). Thus, each 
sheet had either four or 12 photos per sheet. 
The quartets were generally 23 picas by 
28.5 picas (3% " x 4%") or 13.5 picas (2'/ 4 ") 
square. Since neither I nor the printer who 
would create the negatives for the printing 
plate wanted to mess with getting all the 
photos reduced or enlarged to the same size, 

1 sought to keep pictures at a standard per- 
centage of their original size (100% filled 
the bill nicely). And 23 picas is a nice size 
to accompany 11/13 type (11-point type with 

2 points extra leading). 

I was working within a web frame that 
measured 42 picas wide and allowed 44.5 
picas of text area below the webbed corn- 
ers. Discount a pica from either side of the 
frame, and I have 40 picas of text area. Sub- 
tract 23 picas for the main text, plus a 
1.5-pica space for breathing room between 
main text and the sidebar area, and that 
leaves 15.5 picas. At 115%, the 13.5-pica 
pictures fit in the sidebar area. If I includ- 
ed the photo inside a box in the 15.5-pica 
sidebar area, the photo could stay at its 
original size. Thus, I would generally work 
with three photo widths: 15.5, 23 or 40 
picas. 

I could also go against this asymmetri- 
cal text arrangement with two 18-pica 
columns of sidebar text with two picas be- 
tween the columns and a pica on the out- 
side margins. Optimum layout flexibility 
was achieved using a pica rule and calcu- 
lator even before I turned on the computer! 

Now the tagging operation could begin. 
Here are a few examples: 

~ Body text: Schoolbook, 11 point; 13 fixed 
leading (or 2-point Auto); no change in 
character spacing; no baseline settings; no 
margins; 12-point (1 pica) paragraph indent; 
word justification (never use character 
justification for books); no fill or color. 

~ A head: Schoolbook, 15 point; 18 fixed 
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FOLIOS GO HERE 



Meet the Family from 
'J Mockingbird Heights, U.S.A. L 



Let mo introduce you to the Munsler Family, mi un- 
usual clan of monsters that live in a mansion fit for Dr. 

Frankenstein, Dr. Phibcs. or Norman Bale;;. "The 
Muna t era" derive ll inspiration from Hollywood's early 
horror films. 

Merman Munsler. who greatly resembles Franken- 
stein's monster (a la Boris Karloff}, is the head of the 
household. His matronly wife, Lily, is a Vamplra with 
thediched duties of a housewife. She cooks, eleans the 
dungeons, and dusts. Their world centers on their 
residence al 1313 Mockingbird Lane, Mockingbird 
Heights. U.S.A. 

Herman and Lily's only son. Eddie, is an eight-year- 
old in grade school growing up with the normal yearn- 
ings of a youngster his age— except he's green and has 
pointed ears. But his chums don't mind that. 

Next in line is Lily's father, affectionately known as 
Grandpa. He's a~ AH 1K cantankerous old vampire l-i 
from Tran syl ■ » -^ vania who smokes a stogie 
and enjoys a Kl*t1 E°°d laugh. His hobby, 
)rming i^* .' w ''^ experiments in his 

base- 
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WILL BE TRIMMED 
AT PRINTER 



leading (or 3-point Auto); -4 character 
spacing; center. 

Remember that the line measure is "set" 
by the text column created, which, in this 
case, is 23 picas for the main body of text. 
For the sidebars, however, the text column 
would be only a guide for creating boxes 
for photos or boxed and screened text, thus 
indents would come into play. 

~ Sidebar: Avant Garde, 10 point; 12 fixed 
leading; 12-point left, 12-point right, in- 
dents; 12-point paragraph indents; word 
justification. 

" Sidebar head: Avant Garde, 14 point; 17 
fixed leading; 12-point left, 12-point right, 
indents; center (even though it's centered, 
I still have to account for the space needed 
between head and box rules that will en- 
close it). 

Note that I can use the same tag for the 
sidebar whether it is 20 picas with the ex- 
tra space in-between text columns or 15.5 
picas in the outside text columns. Yet each 
kind of sidebar will be distinct. The same 
kind of text coding cannot be done with 
regular typesetting. So, yes, there are a few 
advantages to DTP after all! 

When handling special situations, like us- 
ing bullets or having the first paragraph of 
a chapter not indented, PageStream is some- 
what awkward. First, you need to set up the 
tag for the main body of text, then click on 
ADD to save it. Then hit Escape and re- 
name the tag appropriately. In the case of 
a bulleted list, just change the font to the 



bullet font {PageStream currently has 
"Dingbats" and Jay Pierstorffs excellent 
"Crackers" fonts), keeping all other specs 
the same. In the case of an unindented first 
paragraph at the start of a chapter or a break 
in the body-text, click on the body-text tag, 
rename it and change the paragraph indent 
to zero. 

Once the tagging system is in place, save 
the document as a template. Since I used 
the web frame in the same position for each 
left and right page, I also loaded it onto the 
master pages and put it into position before 
saving a template. From there on, each 
chapter would be named (using "Save 
As. . ." under the File menu) immediately 
before proceeding with any work in order 
to preserve the blank master document. 

Speaking of master pages, I have yet to 
see the real value of the master pages as far 
as setting up text columns, since it appears 
you cannot load text into the text column 
thus displayed on pages 1, 2, 3, or so on. 
The Create Columns option does not take 
into account double-sided pages (left-right 
distinctions), so it does not serve my needs 
in regard to asymmetrical left-right pages. 
The beta copies I've used so far do not seem 
to improve the situation, but perhaps it is 
improved in Version 1.6, which is available 
to registered owners. The only trick I can 
suggest is to use the text columns created 
from the master page as guides for creat- 
ing separate columns on each page. 

So the next step I took was to create a left- 



hand master page with the 15.5-pica column 
on the left and the 23 -pica column on the 
right. I also created text boxes for the dis- 
play text and quote text, even though such 
text does not appear on every page. Final- 
ly, I placed left and right folios (page num- 
bers) centered below the bottom of the web 
frame. I used the LM and RM codes that 
automatically set the appropriate page num- 
bers (right-hand pages are always odd- 
numbered; left-hand pages, even- 
numbered). Then I saved the master docu- 
ment one last time. (Note that I will break 
the book into a number of chapter docu- 
ments, and so assign each chapter's master 
pages with appropriate starting folios.) 

The Hypothetical 
Layout Process 

Had we actually proceeded with desktop- 
publishing the book, the procedures out- 
lined below would have been followed. The 
copyedited manuscript would have been 
typed on PCs using WordPerfect. This is the 
routine the publisher follows for creating 
scannable printouts for its typesetting sys- 
tem, but the typists would have inserted 
typesetting codes into the text. The disk 
files I received would have been unadorned 
WordPerfect 4.1 files on 3.5" disks that I 
could easily read into my system, and into 
PageStream after breaking up the chapter 
files into sidebars and such. I would not 
have wanted to flow regular text and side- 
bar text together. 
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do not beltm we should push Marilyn's romance lta[, ir Marilyn's cluck of 

romance hnn begun to tick, it docs not behoove us to overwind her 

mainspring.- Herman Munslcr 



Let me introduce you lo the Minister family, an 
unusual clan or monsters who live in a mansion fit for 
Dr. Frankenstein, Dr. Phibes, or Norman Bates. The 
"Munsters" derived inspiration from Hollywood's early 
horror films. 

Herman Munster, who greatly resembles 
Frankenstein's monster (ala Boris karloU), is the head 
of the household. His matronly wife, Lily, is a 
Vampira with the cliched duties of a housewife. She 
cooks, cleans the dungeons, and dusts. Their world 
centers on their residence at 1313 Mockingbird Lane 
and ion their town, Mockingbird heights, U.S.A. 

Herman and Lily's only son, Eddie, is an 
eight-year-old in gr ade sch ool, growing up with the 
norma] yearnings. 



age— except 

But 
Next in 
affectionately 
known as 
Grandp; 



younster his 
green and has pointed 







MUNSTER ODDITY 

Young Jackie Coogan, Jr.. 
mode a guest appearance as 
one of Eddie Minster's friends in 
the episode 'A Mon foi Marlyn' 
Meanwhile, his father-actor 
Jackie Coogan— was busy 
portraying Uncle Fester for the rival 
show, •The Addams Family." on 
another network. 





tionately known as Grandpa. He's a cantankerous 
old vampire from Transylvania, who smokes a 
stogie and enjoys a good laugh. His hobby, per- 
forming experiments in his basement laboratory, 
gets him into trouble, but he's always forgiven. 
Who could stay mad when good intentions are at 

The last entry to the family tree is the most 
unusual. She is the beautiful neice, Marilyn, 
whom the ghoulish Munsters fret over and protect 
for the cruel trick nature played in making her so 
"plain." 

As you can see, these are ordinary, upright 
citizens. By their standards, they are the 
ail-American suburban family that just happens to 
be monstrous, a detail that has escaped their 
notice. They do not know they are different in any 
way, and are proud of their monster heritage. 
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My first-pass galleys probably would 
have followed my page format, but without 
the web frame to save file overhead (and 
thus printout time), since I could easily add 
the frame to the master page of each chap- 
ter document later, when camera-ready 
printouts were needed. After proofing, I 
would have made corrections within Page- 
Stream and then began the layout by adding 
"photos" in the form of boxes drawn to the 
size of the photo. I would still have to crop 
and mark the photos for size outside the 
program. Only for photos where I would 
have outlines (the background cut away, 
leaving heads or other prominent fore- 
ground features of a photo) breaking into 
the text would I need to use scans. And 
those scans, however nice they might look 
using halftone mode in Navarone's ST Scan 
(special thanks to Coz Computers in Chica- 
go for its use), would be for position only. 
Again, to avoid file-size problems, I would 
have likely foregone halftones and gone no 
further than 150 dpi (although my sample 
did use a 300 dpi scan of the Munster 
family— just showin' off!). 

Doing page-sized galleys from the start— 
unlike what we traditionally do with first- 
pass galleys— would have put us ahead of 
the game by having an idea of the page 
count before photos were inserted. And 
there's always somebody looking over my 
shoulder, wondering about the length of the 
book. . . . 



Clicking Off 

Except for the problem of 300 dpi PS out- 
put being unacceptable and the Lino ser- 
vice being too expensive, it would have been 
possible to do this book using PageStream 
and the other ST programs, like WordPer- 
fect, Touch Up, Easy Draw and ST Scan. 
It still would have required some tradition- 
al hands-on work with scaling and cropping 
photos, but I've been doing that stuff for 
years. The point is, we do have the tools 
to do serious, professional publishing with 
Atari hardware and software. 

I'm probably going to return to this book 
project one last time in order to illustrate 
the power and applicability of the ST to 
real-life DTP tasks. Then I'll be looking into 
various other areas of personal-publishing 
topics. Next month, however, Christmas 
comes upon us, and I've always wanted to 
play Santa's helper and discuss stocking- 
stuffers and gifts for the personal publish- 
er in your life. I'll try to give you my choices 
from among word processors, drawing pro- 
grams, accessories, utilities and hardware, 
as well as DTP programs and an odd game 
or two. 

1 This is a page from the layout for the 
Munsters book. You can see the web frame 
as well as all the blue lines (the arrows and 
"15 'A picas" are not meant to print, but are 
there as a guide for the key liner) . The gal- 
ley was cut up in order to do the "wrap" 



around Herman Munster (note the bit of hy- 
phen in "Transyl," the lack of hyphen af- 
ter "transyl ," and "vania" on the other side 
of his head). The broken diagonals below 
the webs are also non-reproducible to the 
printer's camera and mark off an area where 
text should not go, as well as marking where 
the text area begins. Photo 1-2, like the 
majority of photos in the book, is drawn for 
position, with measures for the keyliner to 
reproduce on the boards. The printer will 
place the halftones (the printable versions 
of the photos) into position. (All illustra- 
tions of the Munsters in these samples are 
copyright 1989 by MCA Publishing Rights, 
a Division of MCA Inc. Used with per- 
mission.) 

2 This page shows many of the elements 
that had to be considered in designing the 
Munsters book: display text, opening quote, 
opening paragraph and body text, sidebar, 
folio and caption. There's also some fun 
stuff with the webs and bats, to say noth- 
ing of the text w raparound and photos. One 
tiling lost from the return to traditional type- 
setting was the shadowed text since the pub- 
lisher did not have the font. On the other- 
hand, the bats will be treated to a 40% gray 
screen and print under the larger "MUN- 
STER ODDITY" head. (All illustrations of 
the Munsters in these samples are copyright 
1989 by MCA Publishing Rights, a Divi- 
sion of MCA Inc. Used with permission.) 

(CONTINUED ON PAGf 64) 
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TYPING IT IN 

Type in Listing 1, using BASIC Editor II 
to verify your work, and save the program 
as MEMATCH.BAS. Then Type in Listing 
2, again using BASIC Editor to verify your 
work, and save a copy to disk. Listing 2 cre- 
ates a file named MEM.LST, which con- 
tains some hard-to-type lines that should be 
merged with Listing 1. To merge the lines: 
LOAD "D:MEMATCH.BAS", ENTER 
"D:MEM.LST" and finally SAVE 
"D:MEMATCH.BAS". 

PLAYING THE GAME 

Memory Match can be played by one or 
two players. A one-player game requires a 
joystick plugged into port 0. Plug another 
joystick into port 1 for a two-player game. 
Press Select to change the number of play- 
ers. Press Option to turn the sound effects 
off, if you like. Press Start to play. 

The goal is to match all the cards in the 
fewest number of turns. Rank yourself ac- 
cording to the number of turns it takes you 
to complete the game. 

12-22 turns: You must have ESP! 

23-29 turns: Not bad. 



30+ turns: Are the sound effects distract- 
ing you? 

ABOUT THE PROGRAM 

Memory Match is written in BASIC and 
uses a machine language USR routine con- 
tained in the string MM$. The routine co- 
pies a string of memory to a new location. 
The call format is X=USR(ADR(MM$), 
MEM1,MEM2,NUM), where MEM1 is the 
address of memory to copy from, MEM2 
is the address of memory to copy to and 
NUM is the number of bytes to copy. This 
routine is used to move the modified 
character-set data (lines 9010-9070) to an area 
of memory that begins four pages (each page 
is 256 bytes long) below the last usable ad- 
dress of RAM. The routine also copies the 
DLI (display-list interrupt) data in line 9080 
to page 6 and copies the cursor data in PL$ 
to player/missile memory (line 20). 

CONCLUSION 

I hope you enjoy Memory Match. It's a 
fun game in which the graphics and sound 
effects enhance the playing experience. What 
better way to improve your memory? r 
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Joe Brzuszek is majoring in computer 
science at the University of Pittsburgh and 
has owned his Atari 800 since 1983. He uses 
his Atari as a VT-100 terminal to communi- 
cate with a VAX mainframe computer system. 



Multi-Sync with Atari ? 
YES!!! 




Suggested retail *NOW ! 

OmniSwitch $129.95 $89.95 

Samsung CN4SS1 

Multi-sync Monitor $799.00 $499.95 



Inside CA. 
Outside CA. 



(619) 792-6511 
(800) 243-0443 



TALON TECHNOLOGY GROUP 



U.S. 
243 S. HIGHWAY 101 
JK.308 

Solatia Biach.CA 92075 
phone (619) 792-6511 
FAX (619) 792-9023 



U.K. 

31 Palace Street 
London. SWIE 5HW 
phone (01) 828-9755 
FAX (01) 630-7343 
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NOW, FOR THE FIRST 
TIME YOU CAN HOOK-UP 
YOUR ATARI TO A 
MULTI-SYNC MONITOR! 

• Multi-svnc monitor port: 

Gives your Atari the ability to use a 
millti-sync monitor. Color or B/W 
with the touch of a button, 
(low, medium, and high resolutions) 

• Color and monochrome 
monitor ports: if you do not 

have a multi-sync monitor, Omniswitch 
allows you to plug in color and B/W 
monitors and switch between them. 
NO MORE CABLE SWAPPPING! 

• Floppy drive ports: Enables 
you to use two external floppy drives 
instead of one! 

(uses 3.5" and/or 5.25") 

• Audio .Tack to plug in to your 
amplifier. 

• Video lack for composite TV 
plug in. 

• Dimensions: w 7.75" x D 4.25" 

XII 1.25- 
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TECH WAY SALES 

P.O. BOX 605 WARREN, Ml 48093 

1-800 USA-8832 

IN MICHIGAN CALL 1 (313) 751-8807 

WE SPECIALIZE IN ATARI & THE ST LINES! 



SOFTWARE & HARDWARE 
WITH A FULL LINE OF ACCESSORIES 



ALL SOFTWARE 30% OFF 

LIST PRICE EVERYDAY!! 



WE CARRY ALL THE MAJOR NAME 
BRANDS OF SOFTWARE , HARDWARE 
AND PERIPHERALS FOR THE ATARI'S 



PRINTERS-MODEMS-MONITORS 

HARD DRIVES-LASER PRINTERS 

MIDI KEYBOARDS-JOYSTICKS 

AND MUCH, MUCH MORE! 



WE WELCOME C.O.D. ORDERS 
MOST ORDERS SHIP OUT IN 24 HOURS! 



CIRCLE #115 ON READER SERVICE CARD. 
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In Sun>ey Sweepstakes you play against an egotistical adversary— a 
built-in obnoxious opponent who affectionately calls himself "Know- 
ing Norman." He has a carnival -barker personality and is the kind 
of player you'd like to kick in the pants. There is also a third party 
in this game: the computer. The computer is in charge of the game. 
It selects the questions, acts as referee and keeps track of all the cal- 
culations and displays. 

The computer has conducted a survey in order to discover such things 
as, for example, the five most popular drinks. (Oh*, you didn't know 
that computers.take a little nip* once in a while?) The Atari pits you* 
against Norman and challenges you to name three of the favorites in 
each round. Pretty <easy, huh? Correct answers get you points; incor- 
rect" answe'rs get points 'for the opponent. 

PLAYING THE GAME 

First, run the file SWEEP. PRG (use low resolution), and you will 
see a/ile selector from which you may choose a question file. (Even 
Vanna and Pat don't let you do this.) A sample file'of 75 questions 
is on this month's disk. Later in this article, I will tell you how to cre- 
ate your own. For now, select the Click QUEST. SWP file. You # will 
then see the questions loading- into memory. ■' « 

After the questions have-loaded, you'M see the set-up screen, where 

you'll find Knowing Norman and be asked to enter your name for this 

game. In subsequent games you can just hit Return, because your name 

will already be entered. Otherwise, you, may enter any name up to 25 

■ . characters long. To correct any mistakes, use tj] 

backspace key. When, you're done, press 
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Return. Now you will be asked if you 
" ■■& would like the answers revealed. If you 
select "Y," you'll see the computer's 
answers after every round. If 
you enter "N," you will not be 
given any answers during the 
game, which will keep you 
from memorizing them. 
Answer accordingly, and 
Press Return. 

You will now be told 

the number of rounds you'll 

' be playing. The computer will 

' select anywhere from five to 

r ten rounds. Don't worry. If you 

'get tired of playing, there's a way to 

leave the game be fore it's over. I'll get 

to that later. 

The screen will pause for a few seconds, 
and then you'll be sent to the main play 
screen. Before starting play, take a close 
look at the screen. You will see two black 
windows outlined in white. The left win- 
dow is yours (see your name over it?). The 
right window belongs to Norman. You can 
see his picture and name over this box. The 
long white window toward the bottom of the 
screen is where you'll read the polled ques- 
tions. These questions have been created 
and secured by the mythical Brice- 
Waterhose, Inc. You can begin play by 
pressing the return key. 

When you press Return, you'll see a new 
display appear at the bottom of the screen. 
It consists of four indicators arranged as fol- 
lows: < RIGHT > < WRONG > 
< ILLEGAL > <TIME INDICATOR > . I 
will explain these as we progress through 
the game. At the top of the screen (in the 
center) you'll find the number of the cur- 
rent round. This number will increase 
throughout the game until you have played 
all of the allowed rounds. 

The Brice-Waterhose window clears, and 
a question appears. The question format is 
the same throughout the game. You'll be 
asked to identify three of the computer's five 
most popular selections. 

You will always play first. (This advan- 
tage will, of course, be offset by an advan- 
tage Norman has.) The border around your 
box will pulse, signaling you to type in your 
first answer. There are several restrictions 
you need to be aware of here. First, you may 
use only 16 characters to answer (includ- 
ing spaces between words). Second, you 
may enter your answer in all lowercase, or 
use uppercase for the first character only. 
Acronyms are the only exception here. 
These must be entered in uppercase only. 
For example, you should enter "Young 



Men's Christian Association" as "YMCA" 
to get a correct answer. After you enter your 
answer, press Return. If you press Return 
without entering anything, the move will be 
interpreted as a wrong answer. 

Let's take a look at those indicators at the 
bottom of the screen. When you give a cor- 
rect answer, the appropriate indicator will 
flash and ten points will be added to your 
score. (Your score is displayed at the bot- 
tom of your window.) If you give a wrong 
answer, points will be added to your oppo- 
nent's score. If you try to give the same an- 
swer twice, or if you try to use an answer 
given by your opponent, the "illegal" in- 
dicator will flash. There's no penalty for an 
illegal answer; you will simply be 
reprimanded, your answer will be cleared 
and you will have to enter something else. 

To- create some suspense, I have added a 
timer. You'll notice that when your window 
starts pulsating, the time in the lower-right 
of the screen starts dropping from ten to 
zero. Finish typing your answer before the 
timer reaches zero; otherwise, you will lose 
ten points to your opponent. 

After judgment has been passed on your 
answer, the computer switches control to 
Norman's window. Norman will enter his 
answer after he has had time to "think." 
(While Norman is a state-of-the-art oppo- 
nent, he is a slow and sloppy typist. How- 
ever, he does make every attempt to be 
accurate, so he will correct any typos he 
makes. Being a novice actually makes him 
a little more human.) 

There are a few other facts you should 
know about scoring and how the game is 
played. There are two types of games: the 
normal game and the bonus game. In a nor- 
mal game the award is ten points. In a bo- 
nus game (announced by a flashing sign in 
the upper-left corner of the screen) the prize 
is 20 points for each correct answer. Points, 
by the way, are multiplied by a random fig- 
ure and accumulated to arrive at a sweep- 
stakes prize, awarded at the end of the game. 

Each question has three of five possible 
answers. But each player does not have an 
infinite number of guesses. Four guesses are 
allotted each player, with one additional 
guess awarded for each correct answer. 
Wrong answers are costly, even in a regu- 
lar game. If a player cannot answer a ques- 
tion correctly, he not only loses the awarded 
points, but the lost points are added to the 
opponent's score. 

Remember the timer I mentioned earli- 
er? When the meter runs out for you, good 
ol' Norman receives ten points (20 in a bo- 
nus round). Unfortunately for you, Norman 



is not subject to this penalty when his tim- 
er runs down. ("Not fair!" you say. Well, 
remember that little advantage you had by 
starting the game?) 

Each round will eventually come to an 
end. Either one of the players will guess 
three of the correct answers, or the round 
allotment will be used up by each player. 
Whoever finishes the round will gain an ad- 
ditional 20 points. 

One other rule of play must be men- 
tioned. Each player has the right to chal- 
lenge at least once in each round. If, for 
example, you are not sure of an answer, sim- 
ply type in the word "Challenge." Norman 
will then have to come up with the^answer. 
If he answers correctly, however, he gets the 
points. If he does not, you will receive 
them. 




At the end of each round, applause will 
be given in the form of a vibrating screen, 
identifying the leader up to that point. At 
the close of the game, another colorful 
screen will announce the final winner, along 
with the money accumulated in the sweep- 
stakes. The player will also be given the op- 
tion to end play or start another game. 

I mentioned earlier that the computer will 
determine how many rounds will be played 
in each game. If you get tired of playing or 
are unexpectedly called away, you may con- 
clude a game by typing the word "Quit" 
during your turn. When you hit Return, you 
will be sent to the final winner screen, 
where you will have the option of ending 
the game. 

CREATING QUESTION FILES 

After playing with the default questions 
(found in the QUEST. SWP file on the 
magazine disk), the game becomes easy to 
beat, so you might like to make up some 
new questions of your own. The games can 
be tailored in this way toward specific sub- 
ject areas or degrees of expertise and may 
be played by your friends. 

A question file is an ASCII file that can 
be created with most word processors or 

(CONTINUED ON PAGE 30} 
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COMPUTERS 



800-782-91 1 

'ORDERS ONLY MON-SAT 8AM-6PM (PACIFIC TIME) 

AUTHORIZED ATARI SERVICE CENTER 

COMPLETE LINE OF HARDWARE & SOFTWARE IN STOCK 



CUST SERVICE 
TECH SUPPORT 

702-454-7700 

TU-SA10AM-6PM 
FAX: 702-454-7700 




GENISCAN ST 



*Easy to handle Scanner featuring 4 1/8" scanning width & 400dpi resolution 
enables you to reproduce graphics & text on your computer screen "Optical 
Character Recognition Mode will capture text images from the page & save 
them in format ready for conversion to text file suitable for word processor 
'Package includes GS-4000 scanner, interface & Scan Edit software 'Powerful 
partner to Desk Top Publishing "Printout for Epson compatibles "Unmatched 
range of edit/capture facilities simply not offered by other scanners at this 
unbeatable price "Adjustable switches for brightness & contrast "Cut & paste 
editing of images "Save images as IMG, Degas, Neo, etc - ONLY $299.95 

OCR SOFTWARE -Teach your Atari to read! 

"Optical character recognition software converts scanned text to ascii'Use 
converted text in your word processor'No more manual transcribing of text'Uses 
special scanning mode of the Geniscan ST'Leam mode lets you teach your 
computer any font - ONLY $89.95 



TRACKMASTER ST 




"Trackmaster track display unit is a 
must for the disk hacker'Simply plugs 
into disk drive port of the ST'Displays 
track number, disk side and read/write 
status as the head moves along the 
dlsk*Two-digit LED display'Displays up 
to track 85"Works on both internal and 
external drives (switchable)*Complete 
hardware solution - no software 
required - ONLY $59.95 



AB Switchbox 24.95 

ABCD Switchbox 39.95 

Printer Cables, 6 ft 14.95 

Modem Cables, 6 ft 14.95 

Serial Cables, 6 ft 9.95 

Parallel Cables, 6 ft 9.95 

Gender Changer.M/M.F/F 4.95 

Null Modem Adaptor 4.95 

RS232 Surge Protector 9.95 

RS232 Wiring Box 14.95 

Diskette Holder,3.5",50 disk capacity... 6.95 
6 Outlet Surge Protector.Wall Mount ... 9.95 

Bulk 3.5" Disks, 50 Pack 39.50 

Printer Ribbons, (Star.Panasonic) 4.95 

3.5" Head Cleaning Kit 4.95 




ST COPY DEEP SCAN BURST NIBBLER 

Copy even highly protected programs in under 60 seconds!! 
Copy MS DOS protected programs with equal ease .'.' 

"Works with one drive or two'Copy Between 5.25" and 3.5" drives'Multiple copy 
option allows many backups from one original "Copy 1 or 2 sides up to 85 tracks 
"Special format parameters for non standard formats "Unique "INFO 
ANALYSER" displays vital disc parameters including sector distribution, 
dispersion, interleave, etc "Easy to use Icon driven program takes the mystery 
out of Disc backup - ONLY $39.95 Upgrades ONLY $1 2.00 

3.5" & 5.25" EXTERNAL DRIVES 

3.5"- "Slimline extra low profile unit 
"Top quality drive mechanism'Fully 
compatible - 1 meg unformatted 
capacity'Can be formatted to 85 tracks 
and 1 1 sectors - ONLY $1 59.95 

5.25"- "Operate in 40 or 80 track 
mode'Rear panel switches to configure 
ALL combinations of computer model 
and track modes'Perfect for use with 
PC Ditto- ONLY $179.95 

RIVE UPGRADE 

'Replace internal 500K drive with a 
full 1 Meg unit*Top quality drive 
unit- Easily fitted- Full 
instructions'Direct plug in 
replacement*No special skills or 
tools required*Minor modification 
to enclosure is required*When 
considering a drive replacement 
remember that quality is most 
important - ONLY $119.95 

USE 

"Twice the tracking speed of the 
Atari mouse ! 

"No more mouse doublers 
required*Softer more positive 
button clicking*More consistent 
double click*Extra long 6 foot 
connecting cord*highest quality 
mechanical parts for for longer life 
and consistent positioning 
- ONLY $44.95 





EPROM BOARD 

"Complete Eprom Board & case "Accepts up 
to 4 X 27256 Eproms "Mapped into the 
cartridge area - ONLY $24.95 

SAMPLER STUDIO 

*A complete sound sampling package 
"100% machine code for real-time functions 
'Saved files are compatible with other 
sampling systems "Sequencer for playback 
via keyboard or MIDI input - ONLY $99.95 

ADVANCED ART STUDIO 

'All the facilities needed for computer 
artwork, sprite & game design in one 
powerful but simple to use system 'Graphic 
tools for home & professional use 'Animated 
sprite designer & world map creator "Icon 
driven toolbox with on-screen help *16 color 
lo res mode operation - ONLY $29.95 

SKYPLOT 

'Most advanced features of any astronomy 
prg. 'Covers 17,000 stars, planets & nebular 
objects 'On line help 'Zoom display thru 12 
orders of magnitude 'Several star chart 
formats supported '3D views "Search 
command 'Compute Eclipse, transits, & 
conjunctions 'supports med & hi res display 
'requires 1 meg mem - ONLY$49.95 



ST SUPERTOOLKIT 

"Whole disk Track & Sector Edit "Read up to 
85 tracks and 255 sectors! "Super HiRes 
display works with Mono monitor only "3 
different editor modes-Drive, Disk or File 
"Direct select function for Bootsector, 
Directory sector "Fully Menu/Icon driven 
"HEX / ACSII edit modes directly on the disk 
"Perfect for the disk hacker - ONLY $24.95 



ST TIMEKEEPER 

"Simple plug-in battery-backed calendar 
clock cartridge'Fits into cartridge 
port'On-board clock chip'Lithium battery 
backed to last up to 5 years* Automatically 
adjusts for leap year etc'Complete with 
install disk and corner clock display'Exact 
time, date etc available on power up 
- ONLY $49.95 



PC DITTO II - $249.95 
PC DITTO II + 5.25" DRIVE - $419.95 
PC DITTO II + 5.25" DRIVE + DRIVE SWITCH - $451, 
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AUTHORIZED ATARI SERVICE CENTER 

LET US REPAIR YOUR EQUIPMENT - 5 DAY REPAIR OR THE SHIPPING IS FREE - $ CALL 

ALL THE LATEST EUROPEAN SOFTWARE 

CALL FOR PRICE AND AVAILABILITY 

AERCO MEMORY BOARD UPGRADES 

ABSOLUTELY THE EASIEST INSTALLATION - UNPOPULATED BOARD - $139.95 
• 1/2 MEG RAM - $80.00 ' 2MEG RAM - $240.00 * 4MEG RAM - $480.00 

COMPLETE LINE OF MIDI PRODUCTS 



MANY OTHER ITEMS IN STOCK - IF YOU DON'T SEE WHAT YOU WANT CALL FOR LOW, LOW PRICES 



"Add $4.00 shipping/handling in the continental U.S.: $7.00 - PR, AK, HI, FPO, APO: $10.00-Canada/Mex: 
C.O.D. orders add $3.00 to above charges: SPECIFIY COMPUTER MODEL WITH ORDER: 



RIO / DATEL 

qion p TROPir ANA AVF UP.7 VISA/Mc'/Checks/Money Orders/C.O.D. Accepted: Please call for return authorization number - returns 
Ofou c. i nunv/raw aavc. ttvi sub j ect t0 a 20 % restocking fee: We reserve the right to substitute products of different appearance but 
LAS VEGAS, NV 891 21 equal quality and function for items pictured above: Prices subject to change without notice. 



800-782-9110 

702-454-7700 

IN NEVADA 
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(CONTINUED FROM PAGE 28) 

text editors. There is, however, a definite 
format to the file that must be followed. 

To make a file, the first item you must 
type is the number of questions you will 
create. You may put this information in later 
if you are not yet sure of the number of 
questions. After this, press Return only 
once. Next, type your first question. This 
must be two lines of no more than 40 
characters each. Press Return at the end of 
each question line. It is best to organize 
each question to fit on two lines. However, 
if you do not need two lines for your ques- 
tion, just press Return to add a blank sec- 
ond line. 

Now you need to enter ten possible an- 
swers for this question. The first five must 
be acceptable answers. These can be any- 
thing you want. The second set of five an- 
swers must be wrong and will be used by 
Norman for alternative guesses. None of 
these should be the same as the first five 
entered, and none of them should be cor- 
rect answers. The first letter of each of the 
answers should be capitalized and the re- 
mainder in lowercase. Each of these ten an- 
swers must be entered on a separate line and 
followed by a Return. 



To make this a little clearer, let's take a 
look at the setup for the beginning of the 
default file on the magazine disk: 



ve mst 
n. 






proved 



75 

Our conputers have polled for the fi 

popular colors, Identify three to vi 

Red 

Green 

Blue 

Orange 

Yellow 

Black 

Purple 

Pink 

Burgundy 

Tan 

which three of five board gaites have 

Host popular in our polls? 

Monopoly 

Life 

Scrabble 

Clue 

Checkers 

Chess 

BackgaHMon 

Beat the Clock 

Boggle 

Othello 



When you save your questions as an AS- 
CII file, you may use any filename for the 
first eight characters. But the extender must 
be .SWP. If the file does not load properly, 



go back and check that you have followed 
the format carefully. Creating the questions 
can be time-consuming and requires some 
invention, but it can be fun and education- 
al. I found the almanac and encyclopedia 
to be of great help. Within a short time, you 
can have an informative collection of ques- 
tions and a whole new game to offer your 
friends and relatives, m 





Albert Baggetta is an English teacher and 
a professional guitarist. He lives in 
Agawam, Massachusetts, with his wife, 
Beverly, and his two children. He frequently 
can be found wandering the ST SIG on 
DELPHI. 
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850 N.W. 57th Court - Ft. Lauderdale, Florida 33309 - (305) 938-9755 
IMPORTERS OF FINE EUROPEAN SOFTWARE 






(30S) '7"7' X -^ XS X 



/Falcon Mission Disk 


28.00 \ 


Rick Dangerous 
Bloodwych 
Sleeping Gods Lie 
Waterloo 


30.00 
32.00 
30.00 
30.00 


Wlerd Dreams 


30.00 


KULT 


30.00 


New Zealand Story 
AARGH! 


30.00 
30.00 


Rodeo Games 


30.00 


Garfields Winter Tail 


30.00 


High Steel 
Asteroth 


30.00 
32.00 


Spherical 


30.00 


The Story So Far 

Ikart Warrior, Buggy Boy, Beyond Ice Palace, Battleshl; 


30.00 I 

> 


Triad 3 Pack 


20.00 


Barbarian, Defender of Crown, Stargllder 




V CALL. US - NEW TITLES DALLY ! 1 M 



MAGAZINES 



ST ACTION -Now With Disk $7.00 

ST USER - Now With Disk $7.00 

ST FORMAT - With Disk $7.00 

ST WORLD $5.00 

THE ONE $5.00 

THE GAMES MACHINE $5.00 

ACE $5.00 



Yearly Subscriptions Also Available 




520, 1040,MEGA, XL & XE 

UPGRADES & PARTS 
ALSO AVAILABLE 
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Increase your 

publishing 

power. 




Migraph 
Hand Scanner 

Add scanned graphics to all your projects quickly 
and easily with the Migraph Hand Scanner. 



The Hand Scanner provides a 
scanning window over 4" wide with 
four scanning resolutions: 100, 200, 
and true 300 and 400 dots per inch. It 
also offers adjustable contrast, three 
dither settings for scanning halftones, 
and a special setting for line art. 

Build your own library of images. 
Logos, photographs, books, 
illustrations . . . provide you with an 
unlimited supply of art. 



Touch-Up,™ Migraph'shigh 
resolution image editor, lets you scan 
and edit your images. Powerful 
editing tools include crop, invert, 
resize, flip, cut and paste, multiple 
zoom levels, a full array of paint tools, 
and much more. 

When your images are "pixel 
perfect", import them into your 
favorite ST publishing programs like 
Calamus, Fleet Street, PageStream, 
and Publisher ST. In addition, several 






save formats let you use your images 
on the PC and Mac. 

The Migraph Hand Scanner and 
Touch-Up. Powerful tools for 
professional publishing. 

See your dealer today for more 
details or call us direct. Dealer 
inquiries invited. 

For all Atari ST and Mega systems with 
monochrome or color monitors, 1MB 
memory and 3.5" DS disk drive. 



200 S. 333rd St., Suite 220 



Federal Way, WA 98003 (206) 838-4677 (800) 223-3729 (Pacific Standard Time) 



: CopyngM 1989 Migraph, Inc The Migraph logo is a registered trademark and Touch -Up is a trademark o! Migraph, Inc. 
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Products mentioned: 

FIRST PAINT 
FIRST TYPE 
JIGSPELL 
COLOUR STRIP 
SPRINTER 
BLOW UP 
Hat Software 
21 Wyle Cop 
Shrewsbury, Shropshire 
England SY1 1XB 

FORGET ME CLOCK II 
DISK DUPLICATOR 

P.O. Box 113 

Harrogate, North Yorkshire 

England HG2 OBE 

HAWK COLIBRI 

MATSCREEN-MUO 

METEOSAT 

Signa Publishing Systems Ltd. 
3rd Floor, Alexander House, 
Station Road 
Aldershot, Hants 
England Gull 1BQ 



KICK OFF 

Anco Software 

Units 9-10, Burnham Trading Estate 

Lawson Road, Dartford, Kent 

England 

MULTIGEN 

Digita International 
Black Horse House 
Exmouth, Devon 
England EX8 UL 

PARSEC 

Elmtech Research 
6 Witherford Way 
Selly Oak, Birmingham 
England B29 4AX 




TWYLYTE 
METROPOLIS 
TRITON 3 
STOMP 

Software Horizons 

5 Oakleigh Mews 
London, England N20 9QH 

OUTLAND 

Pandora Software 
Mercury House, Calleva Park 
Aldermaston, Berks 
England RG7 4QW 

VIDI ST 

Rombo Ltd. 

6 Fairbairn Road, Kirkton Road 
Livingston, Scotland EH54 6TS 



THAT'S FUN FACE 

Compo/Holland 
Cavendish Distributors 
85 Tottenham Court Road 
London, England Wl 



I 



SPECIAL CHARTER SUBSCRIPTION RA 

Y/////// 6 ISSUES 
ONLY $13.95 

SAVE 40% Off 



ICEC 





□ SIGN ME UP FOR 6 ISSUES OF LAPTOP MAGAZINE FOR ONLY $13.95! 

□ PAYMENT ENCLOSED □ BILL ME CHARGE MY □ VISA D MC 

No EXP SIGNATURE 

NAME 

ADDRESS 

CITY 



STATE . 



ZIP. 



Money back on unused subscriptions if not completely satisfied. Foreign add $7. Make checks 
payable to LFP, INC., Your first issue will arrive in 6 to 8 weeks. Watch for it. 

CJWYV OH" «»plr»« Nov.mb«r 26, 1»B9. 
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I think the game could 

be richer and more 

appealing to a wider 

audience iff there was 

more to do than kill 

anyone who approaches. 



Maybe I'm just getting old. 

I was in Electronic Play world a few weeks 
ago asking what's new. Richard pointed out 
a game called Battletech, a graphic adven- 
ture from Infocom. Now, that interested me, 
because I've always had a high regard for 
Infocom's games. 

"What's it about?" I asked, always a dan- 
gerous question. 

"It's based on the Japanese cartoon se- 
ries," he replied, as if that was all I needed 
to know. 

Unfortunately, it stumped me. Japanese 
cartoon series? I wasn't aware that any Jap- 
anese cultural figures had made enough im- 
pact on these shores to be recognized by 
more than a few film aficionados. Toshira 
Mifune is modestly well known enough, 
thanks to his role as Toranaga in the Sho- 
gun mini-series, but mention Kurosawa to 
Rambo-level moviegoers, and all you get is 
"huh?" When you've got pop comic stars, 
you know we're at an intense level of cul- 
tural exchange. Does this mean they're 
reading Batman over there? 

I'm not a television watcher, so I haven't 
the foggiest idea if "Battletech" is a show. 
For me, a heavy week of TV watching is 
four hours, and that's probably two or three 
hours of PBS specials and a couple of 
M.A.S.H. reruns during dinner. Anything 
more strikes me as bordering on addiction. 
Our set never goes on before 7:00 p.m. and 
is often off for days at a time. If Battletech 
has come on the boob tube, it's slipped by 
me. 

But it's obviously a popular comic-book 
series. I managed to see a cover in a local 
comic shop. I'm not a comics fan; I think 
comics are literature for the hard of think- 
ing. Sure, there's a cult image and a cer- 
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tain amount of fun in the Fabulous Furry 
Freak Brothers or Dr. Atomic, but kids get 
carried away. One of the local bookstores 
is going over from literature to comics 
(where the money is, I'm told), and it fills 
me with a cold dread to be snooping around 
for a collection of short stories by Gogol 
and hear these kids talking about comics as 
if they're important contributions to 
culture— serious discussions on characters 
like Silver Surfer, Dr. Doom and a host of 
others. These kids analyze the characters' 
attitudes, motives, attire and so on. It's 
much like soap operas, I suppose— a fasci- 
nation with the trivial details of a meaning- 
less pastime. But they act as if comics and 
soap operas actually have meaning and 
depth. 

Maybe it's a factor of age. Maybe you 
have to be young to appreciate comic books. 
When I was young (back in the Paleozoic), 
I liked things I have no interest in pursuing 
now: sweet wines, Mickey Spillane novels, 
the radical left, cigarettes— all the follies of 
youth. Maybe when the comic-readers get 
to be my age, they'll grow into more rele- 
vant things. Like sweet wines, Mickey Spil- 
lane novels. . . . 

Of course, when I was a kid, I read a few 
comics, though there wasn't a fraction of the 
number available today, and no one seemed 
to take them seriously. Mostly I chose the 
Classic Comic series, in part because they 
helped get me through school without hav- 
ing to read such tedious tomes as The Red 
Badge of Courage and Wuthering Heights. 
Instead, I had discovered Orwell, Kawaba- 
ta, Darwin and Golding and wanted to save 
my reading time for them. 

Anyway, I bought the game, figuring it 
would be a challenge since I had no precon- 



ceptions about the theme or the characters, 
and also because I wanted to see what In- 
focom was up to these days. 

Battletech reminds me a lot of Sundog, 
an older graphic adventure from FTL and 
still one of the best ST games around (if you 
can find it). The interface is similar. Be- 
cause there's a specific purpose in the game, 
Battletech is more limited than the 
freewheeling Sundog in its available op- 
tions, but overall, it proved quite an interest- 
ing game. I think graphic adventures is a 
direction in which Infocom ought to 
continue. 

One of the rules of an adventure game is 
to discover what the rules are, so I won't 
go and spoil your fun in discovery. How- 
ever, I will give you this: The beginning is 
a peanut-butter sandwich game. Got that? 
No? Here's the theory: There are some 
games where things happen without your 
intervention. With these games, you should 
best walk away and make yourself a peanut- 
butter sandwich and enjoy it while the sys- 
tem goes about its merry way and does what 
it must. In this case, the hint is: money. 
'Nuff said. 

Of course, the documentation you get 
with the game gives a few hints, but no- 
where near enough. You'll learn, but it takes 
a few tries before you uncover some of the 
tricks and secrets. I've only learned a few- 
like how to get out with an intact mech 
suit— but they sure count! Mostly, the docs 
provide a map and mech suit diagram, both 
of which get used a lot. 

The game isn't copy protected, but has 
no provisions for using a hard disk (at least 
none stated in the docs). This is a pain be- 
cause it does a lot of disk I/O, and nothing 
grinds my teeth more than having to wait 
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while the disk whirls. 

For a long time I thought the game in- 
volved little more than careening about the 
countryside in your mech suit, mapping the 
terrain and shooting anyone who came 
close. That sort of activity soon wears thin. 
I finally discovered that the point of the 
game is revealed over a period of time and 
by certain actions you undertake (and in- 
fluenced by the order in which you take 
them). It actually becomes somewhat in- 
volved, like a complex scavenger hunt. 

The user interface is well-designed and 
easy to learn and use. It's very smooth, but 
there are places I wish I had a simple alter- 
native. For example, in combat, one mech 
has nine weapons, which can be individu- 
ally targeted. However, if I want to fire 
everything at one target (the usual case), I 
still have to go through the process of click- 
ing each weapon, then each target. An "all 
weapons/one target" button would be nice. 

Battletech is nowhere near as polished 
and sophisticated as an Infocom text adven- 
ture. The options are severely limited and 
the available range of actions is pretty nar- 
row; but of course, it has graphics, and they 
count for a lot. Still, I would prefer to see 
them apply the same approach to a game 
like Deadline, rich in characters and op- 
tions. Also, the logic in the earlier Infocom 
games had more internal consistency than 
Battletech exhibits, although this is at most 
a minor annoyance. 

The main drawback and the point that ir- 
ritates me the most is that the interaction 
with 95 % of the nonplayer characters has 
to do with fighting— to the death. It's not 
as violent as, say, Techno Cop, but once you 
get your character into a suitable mech suit, 
you go about blithely killing anything that 
moves. A major battle between your side 
and the enemy, resulting in eight or ten 
deaths, is referred to. in the game as "an in- 
vigorating scuffle." Wonder what they'd call 
a nuclear war? 

There's no wildlife in Battletech. I infer 
from this that the wildlife on Pacifica (what 
a misnomer!) was previously wiped out by 
gangs of mech-suited hunters before they 
turned their weapons on each other. 

It's also a male-dominated game, not sur- 
prising given the origin and the topic. 
Comics and violence seem to appeal more 
to young males than females. Even so, a few 
female characters would be pleasant. Not 
only more realistic, but maybe romantic as 
well. Yes, female warriors too. Dungeon 
Master's handling of the sexes shows a more 
mature approach. But since I've never seen 
the comic, I don't even know if there are 
women in the "Battletech" mythos. May- 



be it's all guys. Like the Spartans. I guess 
that appeals to some males. 

I've railed on about violence in games be- 
fore, and here I go again. I think the game 
could be richer and more appealing to a 
wider audience if there was more to do than 
kill anyone who approaches. Once I got 
three mechs together and upgraded, I had 
an almost invincible party. I started to avoid 
combat, not because I was afraid of losing, 
but because it became boring. Click the 
weapon, target, next weapon, target, begin 
fight. Sigh. 

I'm of the notion that there's too much 
violence around us already. I do believe that 
it affects us when we see it on TV, in mo- 
vies or in games. I think we become desen- 
sitized to the real fact of other people's pain. 
It brutalizes the human spirit to be con- 
stantly barraged by violence. A few years 
back there was a controversy over several 
video games (one or two of which were for 
the Atari 800XL) that graphically depicted 
sex, and in one particular case the rape of 
an Indian woman by a cowboy. A lot of peo- 
ple howled in outrage over these games, 
saying they'd affect their kids' perception 
of sex. Some were even perceptive enough 
to protest the way the Indians were depict- 
ed. The same goes for violence. You can't 
see it, hear it, read it, play it in your games 
without being affected by it. 

We ought to have a game-rating system 
like they have with movies— PG, PG-13, R 
and so on. Parents should try anything rat- 
ed R or higher first, to determine if it's 
suitable for their kids. And maybe stores 
should be asked to refrain from selling to 
young kids any game that's not suitable for 
them. I'd rate Techno Cop XX or maybe 
even XXX, obscene violence. Battletech 
would be R. I wouldn't give it to a kid un- 
der 14. 

Much to my surprise and delight, I have 
recently been sent a C interpreter, from 
HiSoft and marketed on this continent by 
Michtron. No, I haven't tried it, but it's the 
next thing on my list. My only worry is that 
it doesn't come with a compiler. The whole 
point of the exercise seems to me to create 
compiled code from whatever language 
you're using. The back cover promises the 
code compiles with "any standard compil- 
er", without bothering to name any with 
which it has been proven. How do I know 
whether what the English think of as a 
"standard compiler" is even available over 
here? If you buy the package and pursue the 
matter, you'll find mentions of Lattice, Az- 
tec and MegaMax C. However, the infor- 
mation about problems using these' 
compilers, differences between various im- 



ST 

plementations and recommendations are 
mighty few. 

A quick glance through the manual rev- 
ealed several typos. But by now I don't 
have to warn you about Michtron manuals, 
do I? 

I have no idea yet how the interpreter 
works with things like the Resource Con- 
struction Set. However, despite the 
documentation, if the program proves work- 
able, it will be a tremendous boon to a lot 
of inspiring programmers who want to sink 
in the C swamp but simply don't want to 
wade through the compiler morass to get 
there. 

Michtron also sent me K-Graph3, a 
graph-construction program reminiscent of 
the old and cherished B/Graph for the 800 
series. On page 15 of the manual, it says, 
"More information on formats is available 
in the REFERENCES section of this man- 
ual." Needless to say, there isn't a REFER- 
ENCES section. And the screen shots were 
entirely left out and had to be included to- 
gether on a separate errata sheet. Page 38 
says this about the Wilcoxon Rank Test: 
". . . .computes the 'W value for the test." 

Hope you understood that explanation, 
because there ain't no more coming. Any 
idea what skewness and kurtosis are? Even 
though they're inadequately explained on 
page 36, the index doesn't mention them. 
Or slope, intercept, quartiles and other con- 
cepts that appear in the docs. Another 
Michtron manual. 

Non-sequitur 
Interruptus 

I adopted two ferrets in June. The lack 
of information about these animals is ap- 
palling. If anyone has any names of books, 
magazines, ferret clubs, articles, reports or 
other information I can use, please contact 
me at: 47 Oakcrest Ave., Toronto, Ontario 
Canada M4C 1B4 or by FAX at (416) 
698-8880. B 




Ian Chadwick is a Canadian freelance 
writer who also does volunteer work at the 
Toronto Humane Society. He and his wife 
share their small house with dogs, cats and 
ferrets, and, at odd times, a time-traveling 
Stenonychosaurus. 
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int x, i, d, len; 
char s2[20], s3[20l; 

strcpg C s2, s 3 ; 

len = strlen ( s2 )1 

i = e; 

d = FALSE; 

for t x=0; x<len; ++x 3 

if t d && s2[x] != ' ■ ) 

++i; 
else 

if ( s2txl == ' ' 3 
d = TRUE; 

if t i == 8 && len < 6 J 

strcpg C &s2Elen], "QQ" 3; 

else 

if I i == 1 II len == 6 ) 
strcpg ( &s2[lenl, "8" J; 

i = 0; 

for C x=8; x<strlenCs23 ; ++x ) 
if t s2[xl != ' ' & s2tx] != 
s3Ci++] = s2Cxl ; 
s3[il = 8; 
strcpg ( s, s3 } ; 



■ ) 



long str_to_long C s ) 

char »s; 

{ 

int x, len, factor; 

long nun; 

nun = 0; 

len = strlen C s 3 ; 
factor = len - i; 
for C x=8; x<len; ++x 3 
nun += Hong) C six! 
return C nun 3 ; 



write_new_inf o C3 
t 

int len, xS 

char sQ0], tnpf ile [641 ; 

FILE *f; 

string = get_tedinf o_str t newacct 
fwrite C string, 1, 26, acctfile 3 
string = get_tedinf o_str ( newacct. 
fwrite C string, 1, 26, acctfile 3 
string = get_tedinf o_str C newacct 
fwrite C string, 1, 26, acctfile 3 
string = get_tedinf o_str t newacct 
fwrite C string, 1, 3, acctfile 3; 
string = get_tedinf o_str C newacct 
fwrite C string, 1, 10, acctfile 3 
string = get_tedinf o_str ( newacct 
no_decinal C string 3; 
balance = str_to_long C string 3; 
fwrite t ^balance, 1, 4, acctfile 
if C fclose C acctfile 3 != 8 3 

forn_alert C 1, "111 [File close 
for C x=0; x<13; ++x 3 C 
sprintf C s, "Xd", x 3 ; 
strcpg C &s[strlen(s3], ".dat" 
ob-tedinfo = CTEDIHFO *3 newf i 1 
tnpfileCOl = Dgetdrv C3 + "a 1 ; 

strcpy C Stnpf ilell], 3; 

Dgetpath C &tnpf i le [strlenCtnpf 
strcpg ( &tnpf iletstrlen ttnpf il 
strcpg C &tnpf i le [strlen Ctnpf i 1 
strcpg t &tnpf ile [strlen Ctnpf il 
if C C f = fopen ( tnpfile, "bw 
forn_alert I 1, "[1] [Error c 
else 

fwrite C &zero, 2, 1, f 3 ; 



■0' 3 * pwrs[f actor— 1. 



_addr, NEUNAME 3; 

iaddr, NEWADDR 3; 

iaddr, NEMCITV 3; 

laddr, NEWSTATE 3; 

_addr, HEMZIP 3; 

laddr, NEWBALNC 3; 

3; 
error!] [0KAV]"3; 

3; 

e_addr[FILENAME3 .ob_spec; 



ileJ], DFLT.DRU 3; 

e3], "SS" 3; 

e3 3, ob_tedinf o->te_ptext 3. 

e3 3, s 3; 

3 3== HULL 3 
reating file!] [OKI" 3; 
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if C fclose ( f 3 != ) 

forn-alert ( 1, "tllCFile close error !] [0K]"3 ; 
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by Arthur Leyen 



t seems like a long time since I sat here 
at the keyboard letting my thoughts flow 
through my fingers and into the computer. 
Actually, it hasn't been that long, just a 
week. But having been overseas for the 
past week, I feel like a portion of my life 
somehow got misplaced. 

You see, I have just returned from the 
Philippines. It was a good trip from a 
business standpoint. And personally, it 
was interesting to see another culture and 
meet people who are both different and 
yet the same as myself. But 20 hours of 
flight time (not counting the multi-hour 
layovers) and crossing the international 
date line twice can leave a fellow tuck- 
ered out, not to mention confused about 
what day it is. 

I brought a laptop computer with me 
to get some work done on the plane and 
in the hotel. No, not the Atari ST laptop; 
it isn't out yet. Anyway, after about three 
hours, the laptop's batteries gave up the 
ghost, leaving me to find some way to en- 
tertain myself for the remainder of the 
journey to Manila. No problem. After a 
couple of movies, several issues of Time 
and Newsweek (read cover to cover), 
some Heinekens and about 14 pounds of 
honey- roasted peanuts, I finally arrived 



at the Ninoy Aquino International 
Airport. 

By this time I felt fuzzy, needed a 
shower and was having difficulty keep- 
ing my eyelids in the raised position. I 
then had a long wait to get my luggage, 
during which I imagined all kinds of hor- 
rors, such as being stranded in a foreign 
land with no clean underwear. The lug- 
gage arrived and I eventually made it 
through the heat, humidity and traffic- 
congested streets of Manila to the hotel. 

Wanting to charge the laptop when I ar- 
rived at my room, I asked the hotel recep- 
tionist what AC voltage was used in 
Manila. She politely told me that 220 
volts at 50 hertz was the standard. Great, 
I thought. I've lugged a 15-pound boat an- 
chor halfway around the world and won't 
be able to use it. She then told me that 
the hotel would be happy to supply me 
with a transformer if I needed one. 

When the bellman brought the trans- 
former to my room, I immediately 
hooked it up. I had the laptop up and run- 
ning in no time. The transformer itself 
must have weighed almost 20 pounds. It 
was enclosed in a large brown wooden 
box that had obviously seen better days. 
In fact, it looked like something out of 



a 1950s-style science - fiction movie. 
Nonetheless, it worked fine during my 
stay at the hotel. 

Two and a half days later I found my- 
self again on a plane heading west, back 
to New Jersey. I also discovered that secu- 
rity is much tighter at foreign airports 
compared to domestic ones. At both Nar- 
ita Airport in Tokyo and Aquino Airport 
in Manila, I had to pass through several 
security checkpoints before entering the 
gate area. These included the security 
procedures customary in the United 
States, as well as being frisked by a secu- 
rity officer and having to be checked by 
another guard with a hand-held metal de- 
tector. My carry-on bags were also care- 
fully inspected and I was asked to turn 
on the laptop computer. 

All the people I met in Manila were 
friendly and polite. In addition to their na- 
tive Filipino language, most of the resi- 
dents also speak English. The standard 
of living there is much lower than what 
we are used to in the United States. Most 
of us don't realize how much we have to 
be thankful for until we see how other 
people live in another part of the world. 

Well, it's now Sunday afternoon. It is 
raining in this part of New Jersey and 
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WELL, IT'S NOW 

SUNDAY AFTERNOON. 

IT IS RUINING 

IN THIS PORT OF 

NEIII JERSEY AND 

KFAFT1DEBK 

IS PLAYING ON 

THE CO PLRYER. 

I'M TIRED, BUT 

GLAD TO BE HOME. 

Kraftwerk is playing on the CD player. 
I'm tired, but glad to be home. 

Dejd Vu 

In April 1985 I started writing The End 
User column in ANALOG Computing. 
For the second half of 1986, I covered 
both the 8-bit and ST computers. When 
ST-LOG became a separate monthly 
magazine in January 1987, I began writ- 
ing the ST User column in that magazine. 
For about the last three years, The End 
User has focused on the Atari 8-bit com- 
puters and computing in general, while 
ST User has focused (understandably) on 
the Atari ST hardware, peripherals and 
software. 

Now ST-LOG and ANALOG have been 
combined. Once again, The End User 
will cover both the 8-bit and ST com- 
puters and the software that is available 
for them. In addition, I will still keep you 
abreast of what is happening in the com- 
puter industry as a whole— and especial- 
ly the Atari community. 

I will continue to bring you news, in- 
formation, application tips, short reviews 
of useful or significant products and what- 
ever else seems of interest to me or you. 
My goal is to continue to make this 
column a place where you can find infor- 
mation on how to get the best from your 
Atari computer (whichever one you have), 
regardless of how experienced you are or 
how much equipment you have. 

As always, I welcome your input on 
what I have discussed or what you would 
like to see covered in the coming months. 
You can contact me electronically on 
DELPHI (ARTL) or CompuServe 



(71266,46). Other correspondence (U.S. 
mail) should be sent to: The End User, 
ANALOG Computing, P.O. Box 
1413-M.O., Manchester, CT 06040-1413. 
If you would like a reply, please include 
a self-addressed, stamped envelope. 

ST TV 

There is a rather good computer show 
on television that I try to catch whenever 
I can. It's called Computer Chronicles and 
in New Jersey is broadcast (irregularly) 
on public station WNYC out of New York 
City. The program is hosted by Gary Kil- 
dall and Stewart Cheifet and usually con- 
tains news, information and short reviews 
concerning computers and software. Im- 
agine my surprise when, on a recent 
show, the entire half hour was devoted to 
the Atari ST. 

This particular show consisted of four 
segments in which ST software and ap- 
plications were demonstrated. Naturally, 
the MIDI interface was discussed. In this 
segment, Passport Design's Mastertrack 
Pro software was shown being used by a 
university music studio. The ST and this 
particular software were described as new 
tools that have revolutionized music edu- 
cation. 

Next, Cyber Paint was demonstrated by 
its author, Jim Kent. Jim stated that he 
chose the ST as the platform for his soft- 
ware because of its color capabilities and 
fast 68000 processor. When asked to 
compare the ST to the Amiga, Jim also 
said that the ST was more reliable, had 
similar color capabilities and was 
cheaper. 

A local Berkeley computer store spe- 
cialist, Vince De Felippo, then described 
and demonstrated the Spectre 128 Macin- 
tosh emulator. Vince demonstrated sever- 
al Mac applications, including 
HyperCard, and stated that these pro- 
grams run about 20% faster on the ST. 
Vince also mentioned PC Ditto, which 
can run MS-DOS programs. 

The following segment featured the 
Steinhart Aquarium in San Francisco. 
Here, the ST is used to help dolphins and 
seals communicate with humans. Marine 
researcher Eric Carlson said he writes 
GFA BASIC programs that allow the ST 
to control the experiments with these ma- 
rine mammals. Eric also stated that he 
likes the sound-generating and graphics 
capabilities of the computer. 

The final segment featured demonstra- 
tions of Calamus and DynaCADD. Using 
a Mega 4 with a Moniterm Monitor, 



30-megabyte hard disk and SLM804 la- 
ser printer, president of ISD Marketing 
Nathan Potechin demonstrated Calamus. 
He described it as an entry-level yet 
professional desktop-publishing program 
with over 350 features. He showed how 
it is truly a WYSIWYG (what you see is 
what you get) program by holding the 
printed output of his demo next to the 
screen. 

When asked to compare DynaCADD to 
the industry standard, AutoCADD, Pote- 
chin said that it has a better interface, runs 
faster and would be equivalent to some 
future version of AutoCADD. Gary Kil- 
dall wrapped up the show by saying that 
the above-mentioned $3,995 system was 
less than you might pay for a laser print- 
er alone. 

Although many ST users would not 
find much new information presented in 
this show, it is heartening to see the ST 
getting some widespread exposure. In the 
absence (so far) of any major national ad- 
vertising by Atari, this kind of media 
coverage may help spread the good word 
about the Atari ST. 

As they say, check your local listings for 
time and availability of Computer Chroni- 
cles. Chances are it will be aired by your 
local Public Broadcasting System (PBS) sta- 
tion. Atari computers are rarely mentioned, 
but viewing the show is a good way to keep 
up with what's happening in the computer 
industry. 

Hand-Held Wonder 

I generally use WordPerfect for word 
processing on my ST. As you probably 
know, it is a powerful program that has just 
about any feature you'd want. That includes 
a spelling checker and a thesaurus. How- 
ever, I usually edit my articles and columns 
from a hard-copy output after a piece is 
written. 

Being away from the computer, I obvious- 
ly cannot take advantage of WordPerfect's 
features. Still, I often need to check the 
spelling of a particular word or rephrase a 
sentence. In addition, I typically need to 
find another word that has just the right nu- 
ance or a subtle variation in meaning. So 
I decided to get a pocket spelling checker 
and thesaurus. 

There are a number of hand-held spell- 
ing checkers currently on the market from 
a variety of vendors. Some have more fea- 
tures than others and they range in price 
from about $50 to over $300. I looked at 
a number of them and settled on one that 
I thought was particularly good. It is the 
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WordFinder 220, made by SelecTronics of 
Minneapolis, Minnesota. 

The six-ounce WordFinder has a tiny 
QWERTY keyboard and measures 4.9 " X 
3 " X 0.8 ." It has a one-line, 20-character 
LCD display, contains a 100,000-word spell- 
ing dictionary and a 220,000-word thesau- 
rus. It can also help you with jumble-type 
games, crossword puzzles and Scrabble. 

One problem with using a traditional dic- 
tionary to check the correct spelling of a 
word is that you first must have a pretty 
good guess at how the word is spelled in 
order to find it. This problem is avoided 
with the WordFinder because it allows you 
to enter words phonetically. For example, 
you could type "crockodial", and it will re- 
spond with the correct spelling, "crocodile." 
To check the spelling of any word, you just 
type it in and press the "spell" key. 

If the WordFinder can't determine exact- 
ly what you typed, it will display its best 
guess and a flashing Right-arrow on the 
screen. The arrow tells you that WordFinder 
has other alternatives for your word. If its 
first attempt was wrong, you can then scroll 
through these other words until you find the 
correct spelling of your original word. 
Sometimes the WordFinder simply cannot 
recognize the word you typed because ei- 
ther it is so misspelled (occasionally) or is 



just not in its memory (infrequently). When 
this happens, the screen displays 
"unknown." 

The synonym function works quickly and 
intuitively and almost makes the task of 
finding alternate words fun. To find a syn- 
onym, you just press the "synon" key after 
you enter the word. At that point, the Word- 
Finder will display its first synonym. How- 
ever, when you type in a word, the 
WordFinder has no way of knowing which 
of the many possible meanings a word can 
have. Fortunately, it has an elegant solution 
to this. 

For example, say I wanted to find a syn- 
onym for "tease." Wordfinder's first syno- 
nym is "seductress," which it displays on 
the screen. Also displayed are a Down- 
arrow and Right-arrow indicator. "Seduc- 
tress" is considered a "concept" word. Oth- 
er words with similar meaning can be 
viewed by pressing the right-arrow key. In 
this example, "temptress," "coquette," 
"harlot," "vamp," etc. , are words that are 
related to one particular meaning of "tease." 

Pressing the down-arrow key reveals 
"mock," "sneer," "toy," and "annoy"— 
additional concept words that represent oth- 
er possible meanings for "tease." When 
each of these concept words is displayed, 
you can scroll through various synonyms 



with that central meaning. For example, I 
was originally looking for a word to de- 
scribe "making fun of someone." But I 
wanted a word that had a little softer impli- 
cation. Pointing to "mock," some of my al- 
ternatives were "joke," "needle" and "rib." 
"Rib" was just the word I wanted. 

The synonym function can also be used 
to determine the meaning of a word. This 
is done just by reviewing the concept words 
that the WordFinder finds for a particular 
word. You can even find synonyms for syn- 
onyms. Proper names, cities, states, coun- 
tries and corporate names are also included, 
complete with capitalization. 

Microlytics developed the linguistic tech- 
nology that allows a 9:1 word compression 
ratio for storing several megabytes of infor- 
mation on the single 256K memory chip 
used in the WordFinder. SelecTronics sells 
the WordFinder 220, under license from 
Microlytics, for $99. If you are interested, 
SelecTronics can be reached at 701 Decatur 
Avenue North, Building 204, Minneapolis, 
MN 55427. Their phone number is (612) 
545-6823. a 

Arthur Leyenberger is a freelance writ- 
er who lives in beautiful New Jersey. He can 
be reached on CompuServe at 71266,46 or 
on DELPHI as ARTL. 



"The most useful program tor the Atari since Print Shop!*" 



FORMS GENERATOR 

for the Atari 800, 800XL, 6SXE, 130XE 

Designed by Jeff Brenner, columnist for Computer Shopper 
magazine, of "Applying The Atari" fame, and author of book 
and magazine articles in COMPUTE!, ANALOG and others 
LOOK WHAT YOU CAN DO WITH FORMS 
GENERATOR: Purchase merchandise by mail? Next 
time, send a customized purchase order form! Does 
your home or business ever need statements, in- 
voices, proposals, job work orders, gift certificates, 
etc.? No problem! Use FORMS GENERATOR'S scrolling spreadsheet- 
style screen to design almost any form to suit your exact needs. What 
you see on-screen is what you get on paper! Use the text mode with any 
80-column printer, or the high-res graphics mode with the Epson, 
Gemini/Star, Okidata, Panasonic or Prowriter for remarkably realistic 
forms. BUT THAT'S JUST THE BEGINNING: Once you've designed a 
form, you can program FORMS GENERA TOR to make all calculations 
automatically! Imagine: after you enter quantities, descriptions and 
prices, FORMS GENERATOR moves about the form calculating ex- 
tended prices, subtotals, and even the sales tax! Like magic! (Sample 
invoices included). You can also use FORMS GENERA TOR for record 
keeping, since you can save filled forms to disk! 

NAMED A "BEST BUY" IN 8-BIT SOFTWARE BY ANTIC MAGAZINE, JANUARY 1988, 

Our "down to planet Earth" price: Only $23.95 (product #ATA611). 



FOR C.O.D. ORDERS CALL (516) 932-5330 



Send coupon to: 

Twenty-Fifth 
Century™ 



City- 
State . 



-Zip_ 



Software Division 
Dept. AT 2 

234 Fifth Avenue 

NewYoriTfJV 1 000 1 DEALER INQUIRIES INVITED. 

New York State residents add 8% sales tax. 
'The Print Shop and Atari are registered trademarks of Broderbund Software and Atari 
Corp.. respectively. — Prices and availability subject to change without notice. 

CIRCLE #108 ON READER SERVICE CARD. 



DYES! Please rush me FORMS GENERATOR (product 
frATA611) with complete documentation, 90-day free 
replacement warranty, full customer service support and 
20-page Atari software catalog. I am enclosing $23.95 
- $3.50 shipping and handling. 

□ Check/Money Order enclosed DC. O.D. (add $2.50) 
Name 



YOUR SOFTWARE 
RENTAL CENTER 

THIS IS THE PLACE 

Life on easy street means 
picking up your phone and 
ordering the software of 
your choice. We carry soft- 
ware for Atari, IBM, Apple, 
520ST, MAC, Amiga & 
Commodore. 

Call us now, toll free, for 
a complete list. 



Call toll-free outside Texas: 1-800-433-2938 
- Inside Texas call: 81 7-292-7396 

WEDGWOOD RENTAL 

5316Woodway Drive 
Fort Worth, Texas 76133 



Discover 



3B 



CIRCLE #107 ON READER SERVICE CARD. 

NOVEMBER A.N.A.L.O.G. Computing 




ST 



by George L. Smyth 

About five years ago I taught program- 
ming and was in charge of the school's 
AlphaMicro minicomputer. As part of my 
job I attended a conference where one of 
the main topics centered around the 
potential proliferation of a self-replicating 
program called a virus. The speaker ex- 
plained how its possible threats, includ- 
ing the alteration of high-level security 
programs, had been demonstrated on the 
Pentagon's computer by a person with the 
lowest level of access. I was alerted to the 
security needs of my company's com- 
puter, but I never thought that this type 
of problem would filter down to the 
microcomputer level. 

When downloading a program from a 
bulletin board or merely exchanging disks 
with a friend, how are you to know if the 
program is virus-free? Precautions can be 
taken, such as installing programs that re- 
strict write activities to specified drives, 
keeping the write-protect window open, 
and booting the system with a newly for- 
matted disk, but viruses can take shapes 
that are subtle or delayed, making them 
difficult to detect. 

The first point of assault against com- 
puter viruses is to gain knowledge — the 
ability to recognize the existence of a vi- 
rus; the second is to gain control — the 
ability to destroy it. At the vanguard of 
this attack is George R. Woodside, who 
has written two programs to help us 
recognize virus symptoms and remove 
them. 

FLU.PRG is a program that demon- 
strates the symptoms of several viruses 
known to exist on programs written for 
the Atari ST series of computers. These 
examples include symptoms that attack 
the sound chip and display, not those that 
are destructive to the disk. By clicking on 
one of the selector boxes, the chosen vi- 
rus symptom is demonstrated. The 
delayed and/or slow-infesting routines are 
sped up to make the demonstration more 
visible. The different examples are: 

• Blot: After the system has been on for 
three hours, the screen is slowly blanked 
out, one pixel at a time. 

• Screen: Similar to the blot virus, this 
one works more quickly and is invoked 
after only 30 minutes. 

• Green goblin: Every 16th disk access 
causes a portion of the screen to be 
flipped upside-down; after 128 accesses 



the virus's "signature" is displayed. 

• Label: Every tenth disk access causes 
the screen to completely blank out. 

• Mad: This category involves eight 
different attacks, including reverse video, 
horizontal and vertical scrolling, and 
scrambling. 

• Maulwurf: After a specified period of 
time, the perpetrator's signature is dis- 
played at the cursor position. 

• Mouse inversion: The vertical orien- 
tation of the mouse is inverted after a cer- 
tain number of new disks are detected, 



Disk Characteristics: 


Drive: 3 


Sides an disk: 2 


Tracks on disk: ail 


Sectors per track: 3 


Reserved sectors: t 


Sectors per FflT: 5 


Copies of FBI! 1 


Director!/ sectors: 


Seli>Eoating, 


Extra FBI sectors zero. 


Disk has a virus. 
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i.e., pushing the mouse forward moves 
the screen pointer down. 
• Pirate trap: Possibly installed by a soft- 
ware vendor or developer, this virus co- 
pies itself to other disks and every 50th 
copy displays a message claiming that the 
user is being watched. 

So what can we do about this? How can 
we know if a newly downloaded program 
is virus-free? What can we do if it is in- 
fected? There are no guarantees, but 
VKILLER.PRG is able to recognize the 
current crop of viruses and erase them 
from the disk. 

Viruses inhabit the boot sector of a 
disk. The boot sector allows a program 
to be automatically executed by resetting 
the computer or powering it off and then 
on, a scheme employed by many software 
developers within copy-protection 
devices. This type of disk cannot be 
checked, since VKILLER.PRG searches 
this boot sector for the presence of any 
information. There is no way to tell if the 
information found in an executable boot 
sector is a virus or represents legitimate 
instructions. Simply stated, if a program 
requires a system reset or shutdown in 
lieu of double-clicking its icon to be run, 
VKILLER.PRG should not be used to 
check the disk. 

The existence of a virus is searched by 
selecting the A or B drive icon. The pro- 



gram displays a happy face if the exam- 
ined disk appears to be clear of viruses. 
A devil's face appears if the boot sector 
contains executable code, characteristic of 
a virus. If the disk does not contain an 
executable boot sector, but instead con- 
tains another form of data where the disk 
should be blank, a question mark ap- 
pears. A virus warning box is displayed 
if the characteristics of a known virus are 
detected. 

If the user detects a possible virus, the 
"Kill" icon should be selected. This oper- 
ation erases the unused portions of the 
boot sector and FATs. Mr. Woodside 
states that all currently known viruses can 
be eliminated in this manner. But, as 
mentioned above, if the disk has a legiti- 
mate use for the executable boot sector, 
the routine will not recognize this and will 
"Kill" the disk just as if it contained a 
virus, rendering it inoperable. 

The program has the ability to detect 
the presence of a known virus in the sys- 
tem while the program is running. If this 
happens, instructions are displayed as to 
the action which should be taken. 

The program displays information 
about the disk, such as the number of re- 
served sectors, sectors per FAT, directo- 
ry sectors and other information. 

The user can also send the information 
contained in the boot sector and FATs, the 
binary values and their ASCII equiva- 
lents, to the screen, disk or printer. This 
is useful to the knowledgeable individual 
who wishes to learn more about virus 
placement on the disk, or to the novice 
who merely wants to learn more about the 
software structure of Atari's disk format. 

To date, 15 known virus types can be 
identified by this program. Mr. Woodside 
urges anyone finding a virus that this pro- 
gram cannot detect to send him a copy 
so that an update can be implemented. 
This is an excellent way to support your 
friendly local public-domain 
programmer, p 




George L. Smyth holds a degree in psy- 
chology from West Virginia University and 
is currently employed as a programmer. 
He is the author of a series of tutorials 
on programming in Forth. 
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New Forum Feature 

If you use the Forum a lot, you'll want 
to know about a recent change that adds a 
lot of power to the DIR and READ 
commands. 

As you know, you can add a number of 
qualifiers to either DIR or READ to speci- 
fy the exact message(s) you're seeking. For 
example, typing DIR TO KZIN FROM 
ANALOG4 will display a list of all mes- 
sages posted to user KZIN by (from) 
ANALOG4. 

You can now use AND/OR logic to fur- 
ther define messages to scan with DIR or 
read with READ If you type DIR TO KZIN 
AND FROM ANALOG4, it is the same as 
typing DIR TO KZIN FROM ANALOG4, 
but using OR is a different matter. If you 
type DIR TO KZIN OR FROM 
ANALOG4, you will see a listing of all 
messages that are addressed to KZIN, as 
well as all messages posted by (from) 
ANALOG4. 

There is one limitation to all this: You 
cannot use AND and OR together in the 
same command. 

If you're a bit confused, just remember 
this basic rule of thumb: Using AND (or 
no qualifier) decreases the number of mes- 
sages selected, while using OR increases 
the number of messages selected. (It's the 
same as using NARROW and WIDEN in 
the databases.) 

Your Personal Online 

Schedule and 

Notepad! 

Want to try something really different- 
something that's not even covered in the 
DELPHI manual (yet)? From the Confer- 
ence menu, or from within a Conference 
group, type /DIARY. This leads to DEL- 
PHI'S SCHEDULER feature— actually an 
appointment calendar and diary/notepad. 

After you type /DIARY, type "?", and 
you'll see this menu: 

4D 



SCHEDULER Menu: 

APPOINTMENT-CALENDAR 

DIARV 

EXIT 

SCHEDULER) CAPPOINTMENT, DIARV) 



Select APPOINTMENT, and you'll be 
able to schedule appointments, which will 
result in your being prompted with a 
reminder note when you log-on on the day 
of the scheduled event. Here's the Appoint- 
ment menu: 



SCHEDULER APPOINTMENT-CALENDAR Menu: 

ADD 

DELETE 

EXIT 

HELP 

LIST 

APPTXAdd, Delete, List) 



The features on this menu allow you to 

add or delete events, and to list all events. 

Select DIARY, and you'll see this menu: 



SCHEDULER DIARV Menu: 

ADD 

DELETE 

LIST 

HELP 

EXIT 

DIARV>Add. Delete or List? list 



This menu allows you to enter notes, 
which nobody else can see. 

When you type /DIARY in a Conference 
group, it is like typing /MAIL in the sense 
that only 1,000 characters of what is typed 
while you are gone will be saved for 
redisplay when you return to Conference. 

Whenever you are prompted for a date 
while using the Appointment or Diary fea- 
ture, enter it using the format MM/DD/YY 
(Example: 03/21/90). If you don't enter a 
date, the current date will be used. (Note: 
When you view a date's schedule or note 
with the LIST command, you can step 
through entries for all dates following that 
date by merely pressing Return at the 
NEXT> prompt that appears.) 

To exit the Diary (or to move up through 
its menu levels), type EXIT or enter 
Control-Z. 




Michael A. Banks 



(If all the foregoing is "Greek" to you, 
type FORUM at the ATARI or ST SIG main 
menu and see what you've been missing! 
The SIG Forums are your main Atari in- 
formation channels.) 

Need Help? 

For help with the Forum, type DA 
GENERAL at the SIG main menu; then 
type READ KZIN1 to see a complete tutori- 
al on using the SIG Forum message base. 
(And look for more tutorials in the near 
future!) 

TQ Tournaments 
Pay Off! 

DELPHI'S TQ Trivia Tournaments are 
still going strong. Fred Boughter 
(FREDHB) was the TQ Trivia Tournament 
champion for May, winning the month's 
grand prize, a desk reference set valued at 
over $200, provided by Grolier. Lots of oth- 
er prizes, including free time, are offered 
in TQ. Type GO ENT TQ at the ATARI or 
ST SIG main menus for more info. 

More Prizes 

DELPHI'S newest online real-time game, 
Fliplt!, also features tournaments. Partici- 
pation in Monday-night games builds a 
jackpot, which is divided among the top 
scorers in each of three categories: best on 
8-by-8 board, best on 10-by-10 board and 
best overall. Type GO ENT FLIP at the SIG 
main menu for more info. 

That's it for now. See you in Conference! 
(Tuesday evening, 10:00 p.m., Eastern 
time; be there, or be an obtuse rectangle!) 

In addition to science fiction novels and 
books on model rocketry and other topics, 
Michael A. Banks is the author of DEL- 
PHI: The Official Guide and The Modem 
Reference, both from Brady Books. You can 
write to him via E-mail on DELPHI to mem- 
bername KZIN. R 

NOVEMBER A.N.A.L.O.Q. Computing 



DATA BASE 

DELPHI 

Make the DELPHI connection 

As a reader of ST-LOG, you are entitled to take advantage of a special DELPHI membership offer. For only $19.95, plus shipping and 
handling ($30 off the standard membership price!), you will receive a lifetime supscription to DELPHI, a copy of the 500-page DELPHI: 
The Official Guide by Michael A. Banks, and a credit equal to one free evening hour at standard connect rates. Almost anyone worldwide 
can access DELPHI (using Tymnet, Telenet or other networking services) via a local telephone call. 

To Join DELPHI 

1. Dial 617-576-0862 with any terminal or PC and modem (at 2400 bps, dial 576-2981). 

2. At the Username prompt, type JOINDELPHI. 

3. At the Password prompt, enter STLOG. 

For more information, call DELPHI Member Services at 1-800-544-4005, or at 617-491-3393 from within Massachusetts or from outside 
the U.S. 
DELPHI is a service of General Videotex Corporation of Cambridge, Massachusetts. 

ATTENTION PROGRAMMERS ! 



ANALOG Computing is interested in programs, articles, and software review sub- 
missions dealing with the Atari home computers. If you feel that you can write as well 
as you can program, then submit those articles and reviews that have been floating 
around in your head, awaiting publication. This is your opportunity to share your knowl- 
edge with the growing family of Atari computer owners. 

All submissions for publication, both program listings and text, should be provided 
in printed and magnetic form. Typed or printed copy of text is mandatory and should 
be in upper and lower case with double spacing. By submitting articles to ANALOG 
Computing, authors acknowledge that such materials, upon acceptance for publica- 
tion, become the exclusive property of ANALOG Computing. If not accepted for pub- 
lication, the articles and/or programs will remain the property of the author. If submissions 
are to be returned, please supply a self-addressed, stamped envelope. All submissions 
of any kind must be accompanied by the author's full address and telephone number. 

Send your programs and articles to: 

ANALOG COMPUTING 

P.O. BOX 1413-M.O., Manchester, CT 06040-1413 
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• so column editing 

• EDITABLE PRINTER DRIVER 

• 30,000 WORD DICTIONARY 
» MAIL MER GE 

• ON SX DISKETTE 



ch >ir\ , M0NiTc« reTOANYC0 ^ rrE PA€KA£E&i'ia 

kLJt7 • PRINTER SmERmCE ?K / M -ATARI XEP80 W l I S 



EVEN; miWEM 



12" MONO MONITOR 
' ATARI XEP 80 
ATAR WRITER 80 



•12" MONO MONITOR 

• ATARIWRITER 80 

• ATARI XEP 80 
« 1025 PRINTER 



$229 



1020 



COMPLETE WITH: 

• 2 PEN SETS 
•1 ROLL PAPER 

• POWER SUPPIY & CABLE 

EXTRA PEN SETS 



COLOR PRINTER 
PLOTTER 



$14.95 



BRAND NEW 

COLOR 
BLACK 



$3.98 
$.89 



I200XL 64K COMPUTER 



$49 



25* COLORS 
XEGS COMPATIBLE 



$69 



1027 PRINTERS 1025 

L™, 1 *™ 1027 IS FACTORY NEW! °°T M *™ X 
Vfj Hvk FORYOUR8-BIT VkQ 

>J5 / S 102S IS RECONDITIONED kUVI^ 



vl 1 






COMPLETE WITH: 

POWER SUPPLY 

IAD CABLE 

DOS 2.5 W/ 

MANUAL 



bisk wwm 

FO& MtflEUXX, 

ATARI 810 $129.00 
ATARI 1050 $169.00 

RECONDITIONED 



$35 



* the mm 

LIGHT GUN 

FOR YOUR 800/XL/XE 



OR THE PACKAGE 



LIGHT GUN 
CRIME BUSTERS 
CROSSBOW 
BARNYARD BLASTER 



$109 



HARDWARE & 



850 PRINTER INTERFACE $79.95 

1010 PROGRAM RECORDER $29.95 

ATARI TWO JOYSTICK SET $9.95 

SPACE AGE JOYSTICK $14.95 

WKX> COMMAND JOYSTICK $19.95 

WICO THE BOSS JOYSTICK $19.95 

ATARI TRACKBALLS $9.95 

ATARI SX212 MODEM $89.95 

AVATEX1200HC MODEM $89.95 

DOS 2.5 W/ MANUAL $4.95 

600XL (NO Transformer) $19.95 

400,800,850.1200X1. Transfomer $14.95 

XIVXE Transformer $19.95 



THE NEWSROOM 

Desktop Publster By 
SPRINGBOARD 



$15 



BASIC CARTRIDGE $4.95 

BASIC TUTOR (2 BOOKS) $4.95 

OJX $4.95 

TURMOIL $4.95 

PAC-MAN(noboj0 $4.95 

DONKEY KONG (no bo>) $4.95 

GORF (400,800) $4.95 

CHICKEN $4.95 

SLIME (400,800) $4.95 

CLAIM JUMPER $4.95 

DELUXE INVADERS $4.95 
JOURNEY TO THE PLANETS $4.95 

STAR RAmOERS $4.95 

MISSLE COMMAND $4.95 

GALAXIAN $4.95 

DEFENDER $4.95 



cartr tois fcm toi wwrnim 



ET 

PACEMAKER 
MATH ENCOUNTER 
DANCE FANTASY 
LOGIC LEVELS 
MEMORY MANOR 
LINKING IXK3C 
DELTA DRAWING 
HEY DIDDLE DIDDLE 
GRANDMA'S HOUSE 
FRACTION FEVER 
ALPHABET ZOO 
ALF 

DIG DUG 
MILUPEDE 
SKYWRTTER 
FOOTBALL 



$4.95 ROBOTRON $19.95 

$4.95 TENNIS $19.95 

$7.95 FINAL LEGACY $19.95 

$8.95 MARK) BROS $19.95 

$8.95 DONKEY KONG JR $19.95 

$8.95 JUNGLE HUNT $19.95 

$8.95 MOON PATROL $19.95 

$9.95 BATTLEZONE $19.95 

$9.95 FOOD FIGHT $19.95 

$9.95 HARDBALL $19.95 

$9.95 FIGHT NIGHT $19.95 

$9.95 ONE ON ONE BASKETBALL 89.95 

$9.95 DESERT FALCON $19.95 

$14.95 NECROMANCER $19.95 

$14.95 RESCUE ON FRACTALUS $19.95 

$14.95 BALLBLAZER $19.95 

$14.95 BLUE MAX $19.95 



STAR RAIDERS II $19.95 
DAVID'S MIDNIGHT MAGIC $19.95 

ARCHON $19.95 

KARATEKA $19.95 

CHOPLIFTER $19.95 

GATO $24.95 

ACE OF ACES $24.95 

LODE RUNNER $24.95 
BARNYARD BLASTER (LG) $24.95 

DARK CHAMBERS $29.95 

AIRBALL $29.95 

SUMMER GAMES $29.95 

CROSSBOW (LG) $29.95 

EAGLES NEST $29.95 

CRIME BUSTERS (1X3) $29.95 

M1CROFILER tfatabose) $39.95 



DAVID'S MIDNIGHT MAGIC $4.95 

REPTON $4.95 

BANDITS (48K 400,800) $4.95 

CLAIM JUMPER $4.95 

TIME WISE $4.95 

DECISION IN TI IE DESERT $4.95 

CRUSADE IN EUROPE $4.95 

KENNEDY APPROACH $4.95 

CONFLICT IN VIETNAM $4.95 

NATO COMMANDER $4.95 

CROSSCHECK $4.95 

MISSION ASTEROID $4.95 



mm software wm im wm&/m 



COMMBAT 
PREPPIEI 
PREPPIEH 
THE COUNT 
FREAKY FACTORY 
LASER HAWK 
CRYSTAL RAIDERS 
ADVENTURELAND 



$4.95 
$4.95 
$4.95 
$4.95 
$4.95 
$4.95 
$4.95 
$4.95 



PIRATE ADVENTURE 

SECRET MISSION 

VOODOO CASTLE 

STRANGE ODYSSEY 

REPTON 

HULK 

AUEN AMBUSH 

GATEWAY TO APSHAI 



$4.95 
$4.95 
$4.95 
$4.95 
$4.95 
$4.95 
$4.95 
$7.95 



JAWBREAKER $7.95 

TOP GUNNER COLLECTION 
(3 GAMES) $9.95 

SILENT SERVICE $9.95 

DISPATCH RIDER $9.95 

SILICON DREAMS $9.95 

F-15 STRIKE EAGLE $9.95 

THE NEWSROOM(1050-64K) $15.00 
VISICALC $29.95 

BOOKKEEPER 

W/ num keypad $29.95 

HOME ACCOUTANT $29.95 



1010 PROGRAM 
RECORDER $29 95 

^K A A^S LtMDV(XJ ° WN R^T^T 



LIGHT SPEE 
DEVFXOPMEN' 



T KIT iJ>Jj t 7J | 
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DECISION IN THE DESERT $4.95 

CRUSADE IN EUROPE $4.95 

KENNEDY APPROACH $4.95 

CONFLICT IN VIETNAM $4.95 

NATO COMMANDER $4.95 

F-15 STRIKE EAGLE $9.95 



monitors ^^ J 



WICO JOYSTICK SALE! 



COMMAND CONTROL 3-WAY 
BLACK MAX 



$14.95 
$9.95 



ASTRA 2@m 

$199 



DOUBLE DENSITY 

DUAL DISK DRIVE 

(2 DRIVES IN ONE CASE) 






MAGIC SAC PLUS 
SPECTRE 128 V1.9 
MAC ROMS 64K 
MAC ROMS 128K 



$59.95 
$169.95 

$19.95 
$129.95 




som mm 

SPE€Ml 



3.5 BULK PACKS WITH LABELS 

1-199 25 -$24.75 1000 -$750.00 



1200XIL CQQ 



• 64K 8-bit COMPUTER 

• 1020 COLOR PRINTER PLOTTER 

• 1025 DOT MATRIX PRINTER (80 COD 

• PACMAN CARTRIDGE 

• BASIC WITH TUTOR SET 

Give the kids something else to play 
with besides your ST! 



3 TO CHOOSE 
FROM! 



HIT DISK 

miKME 



• Sl.AGON 
•GOl.DRUNNF.R 
•JUPITER PROBE 

• KARATE KID PART II 



$29.95 



MEM0M UPGRADES: 



TECH SPECIALTIES 2/4 Meg $149.95 

NEW WORLD UPGRADE 2/4 Meg $139.95 
ARCO BOARD l/2/4Meg $169.95 



smmm 



ATARI MEGAFILE 30 $599 

AWESOME 60+ (60Meg 28ms) $899 

AWESOME 80+ (80Meg 28ms) $999 



m mwm smEmi 



J.A.TO BOARD 8/16Mhz $99 

CMI PROCESSOR ACCELERATOR $299 
Math Co-processor for CMI 12Mhz $99 



kbmmi $49 

Bmigpm Re.*!*.,* 

DESIGN YOUR OWN PC BOARDS!! 



snik PMNnretS; 



STAR NX1000 

STAR NX1000 Rainbow 

STAR NX2400 4 Fonts 



9 Pin $199 
9 Pin $299 
24 Pin $399 



M^IP^M. Iff EMS, 


Mega 4ST Computer 


$1899 


JRI GENLOCK SYSTEM 


$650 


RC AEROCHOPPER 




RC Flight Simul. w/Futaba control 


$199 


ST/IME MODULE 




Battery Backed up Clock 


$59 


IMG SCAN Printer Scanner 


$89 



BEST 

MCMUSt 

KH'I ACKVIKM VKHNl: MM 
THE ST! 




$49 



MAMsmmm 
intEs. s' 



Knight Ore $9.95 

Tracker $9.95 

Advanced Art Studio $9.95 

Guild of Thieves $9.95 

The Pawn $9.95 

Golden Path $7.95 
Universal Military 

Simulator $14.95 

Carrier Command $29.95 

Jinxter $9.95 

Sentry $9.95 

StarGlider $9.95 

ALL ITEMS RFC. $39.95 - $49.95 



SPECIAL 

swmmm 

SMS « >: i 



HIT DISK (4 games) Reg $59.95 


NOW.' 


$29.95 


GOUTRUNNERII 


Reg $39.95 


NOW! 


$19.95 


GRAIL 


Reg $19.95 


NOW! 


$12.95 


INVASION 


Reg $29.9S 


NOW! 


$19.95 


SOCCER 


Reg $39.95 


NOW! 


$19.95 


ZERO GRAVITY 


Reg $29.95 


NOW! 


$19.95 


TFTRA QUEST 


Reg $29.95 


NOW! 


$19.95 


TEXT PRO 


Reg $49.95 


NOW! 


$19.95 


RUNT PRO 


Reg $49.95 


NOW! 


$19.95 


DATA RETRIEVE 


Reg $49.95 


NOW! 


$19.95 


II & DBASE 


Reg $99.95 


NOW! 


$19.95 



smrnm 
smemm 
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SST SEQUENCER V2.0 $99.95 
SONUS MIDI PORT B $69.95 

SONUS MASTER 

PIECE $249.95 

SONUS SUPER SCORE $229.95 



SAN JOSE COMPUTER 



THE A T A R 



STORE 



640 BIOSSOM HII I RD. SAN JOSF, CA 95037 
STORF (408) ??4-8575 • BBS (408) ??4-9Q5? • FAX (408) ??4-8574 



IAX LIS YOUR ORDER! 

FOR FASTER SERVICE PLEASE INCLUDE: 



•NAME 

• BILL TO ADDRESS 
•SHIP TO ADDRESS 

• PI KDNF. « 

• ITEMS) YOU WISH 
TO PURC1 IASE 



VISA / MASTERCARD 
ORDERS ONLY 

CARD ADDRESS MUST MATCH 
BILL TO ADDRESS 



SHIPPING: ADD $5 00 TO ALL ORDERS. AIR AND INTERNATIONAL SHIPPING EXTRA. THAT'S IT 

WARRANTY: 90 DAY WARRANTY ON ALL ITEMS. IAX: CALIFORNIA RESIDENTS ADD 7% SALES TAX. 

PRKPAYMEN 1: USE VISA, MASTERCARD, MONEY ORDER, CASI IIER'S CHECK OR PERSONAL CI IECK. 
PERSONAL CI IECK MUST CLEAR PRIOR TO SI I1PMENT COD.: CASI 1, CASI IIRR'S CHECK OR M.Q ONIY 

Prices subject to change without notice. 

Brand and/for product names are trademarks or registered trademarks of their respective holders. 

Ad produced on an ATARI ST using CALAMUS and printed on an ATARI SLM804 PostScript compatible laser printer 
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C-manship: A Complete GEN Application* Part Four 



(CONTINUED FROM PAGE 7) 

We then open the file in binary-write mode, 

and a call to write new_info() writes all 

the account information to the file, as well 
as creates the monthly data files. 

A call to open acct() actually opens the 

account so the user can enter checks if he 

wishes. (Note that open acctQ is 

represented only by a stub at this point; so 
when you run this month's portion of the 
program, although you can create a new ac- 
count, the account cannot actually be 
opened.) 

If the user exited the dialog by clicking 
on the CANCEL button (FILECANC), we 
exit the dialog without starting a new 
account. 

Function clear newacctQ 

This function simply steps through each 
of the editable text fields in the new-account 
dialog box, clearing them of whatever in- 
formation they may already contain. 
Function get tedinfo str() 

In order to handle dialog boxes with 
editable text fields, it's necessary you know 
how to handle TEDINFO structures (see the 
C-manship in the May '87 ST-LOG). This 
function simplifies the process of getting the 
address of a string in an editable text field. 
Simply pass it the address of the tree and 
the number of the object, and it'll return the 
address of the string. 

Function check_file() 

In order to open a file for a new account, 
we must, of course, have a legal filename. 
The validation string for the dialog's edit- 
able text field will make sure the user enters 
only legal filename characters, but it's up 
to us to make sure that the field is filled in. 
This function simply checks the object 
FILENAME to be sure it's not empty. If it 
is empty, we scold the user with an alert 
box. 

Function no decimal () 

In MicroCheck ST, we have to deal with 
numbers in two ways. The user, since he is 
entering amounts as dollars and cents, needs 
to use decimal numbers; that is, he needs 
to enter his values with dollars on the left 
of a decimal point and cents on the right. 
Unfortunately, this means using floating 
point numbers, which are infamously inac- 
curate due to the rounding operations per- 
formed when calculating with these 
numbers. 

In order to avoid rounding errors, 
MicroCheck ST calculates not with both dol- 
lars and cents, but only with cents. For 
MicroCheck, $100 isn't 100.00, but rather 
10,000. So every time the user enters a val- 
ue, we need, as the first step to making the 



conversion from dollars to cents, to com- 
bine both the dollar and cent portions of the 
number. 

The function no decimalQ accomplish- 
es that task using conventional string- 
handling techniques. The string to be con- 
verted will have one of three formats: dol- 
lars and no cents, dollars and cents, or cents 
and no dollars. The strings, as retrieved 
from the dialog, will take one of the forms 
shown in the first column of the chart be- 
low (none of the strings contains trailing 
spaces): 



St(*ing 

99 99 

9999999 

9 
99 



Actual value After no-deciwalO 



* 99. eo 

99.99 

99999.99 

.90 

.99 



9908 

9999 

9999999 

98 

99 



The strings, when they are retrieved from 
a dialog box, contain no decimal points; in- 
stead, dollars and cents are separated by 
spaces. If the entire field is full, there are 
no spaces at all. Without spaces delimiting 
the two numbers, you have to know the field 
length in order to separate the dollars and 
cents; in this case, dollars can be up to five 
digits, and cents, of course, can be up to 
two. 

The chart above shows the string obtained 
from the dialog, the value it represents and 

the value that no decimalQ will return, 

respectively. Note that the value returned 
is the number of cents, but it's still in 
string— not numeric— form. 

Function str_to_long() 

Once we have the number of cents in 
string form, we need to convert it to long- 
integer form. The function str to longQ 

handles this by multiplying each digit in the 
string times its corresponding value in the 
pwrs[] array. Each product is added to num 
until the end of the string is reached. The 
long integer num will contain the final 
result. 

Function write new_info() 

In order to begin a new account, 
MicroCheck 5Tmust write out the informa- 
tion retrieved from the new-account dialog 
to the .MCK file, as well as create each of 
the 13 monthly data files. These files will 
be named file0.DAT through filel2.DAT, 
where "file" is the filename that was en- 
tered into the filename dialog box. 

All this is accomplished by 

write new_info(). First, we write out the 

user's name and address to the file we 
opened back in newacct_file() (acctfile). 
Then we retrieve the account balance, con- 
vert it to long integer and write it out to the 
same file. 



The last step is to create the 13 monthly 
data files. (Yes, I know there are only 12 
months. The extra file, the one numbered 
"0," is storage for uncanceled checks from 
the previous year, necessary whenever the 
"new year" function is used.) 

We use a for loop to repeat the file- 
creation process 13 times. The loop varia- 
ble, x, is used as the file number and is 
tacked onto the end of the filename the user 
typed into the filename dialog box. The 
complete pathname is tacked onto the file- 
name, as is the extension ".DAT." When the 
filename is complete, we open the file (bi- 
nary) and write out a zero, after which the 
file is closed. (The first word [two bytes, 
that is] of the monthly files is the number 
of transactions in the file; since a new file 
has no transactions, we start off with a 
zero.) 

Conclusion 

That finishes things up for another 
month. If anything I've described in this or 
the past few installments of C-manship 
doesn't make sense to you, you should re- 
view the topic in question. If you want to 
write full-GEM applications, you need to 
know all this stuff! b 

LISTINGS CONTINUED ON PAGE T24 




Clayton Walnum is the executive editor 
of ANALOG Computing, as well as the as- 
sociate editor of VIDEOGAMES & 
COMPUTER ENTERTAINMENT. 



THE JUDGE 

• Decision making 

• Contest judging 

• Classroom grading 



$39.95 



$19.95 



LOFI 

• Loan financing calculations 

TURTL $19.95 

• Graphics fun for kids 8-80 

• Educational 



MORSEY 

• Morse code tutor 



$29.95 



Atari 48K 800/800XL/65XE/130XE Disk 

(NM Tax 5%, US S&H fa) 

Write for product flyer. 

Mead Micro Ware 

10 Bonito PI. 
Los Alamos, NM 87544 
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It's hard to believe, but here we are in 
the seventh installment of Boot Camp. 
We've only got a few more 6502 oper- 
ation codes to cover before we begin 
writing full-scale programs, so hang 
in! The best is yet to come. 

Old Business 

Last issue's assignment asked you to solve 
eight bit-manipulation problems. You were 
given "before" and "after" bit patterns and 
asked to find what operation codes and 
operands were used to get the results. Fig- 
ure 1 shows the completed assignment. 
Some of the problems had two possible an- 
swers. These are so noted, with both so- 
lutions. 

Clever readers have probably noticed that 
the fourth problem actually has far more 
than two possible answers. In fact, by us- 
ing the ORA instruction, Byte 2 could be 
any value with bits 1, 3, 5 and 7 set! Try 
it yourself with a short program. 



BVTE 1 


OPN 


BVTE 2 


RESULT 


ANS 


rBlBBBBll 
L B1BBBB11 


AND 


B18B8B61 


B18BBBB1 


CD 


EUR 


BBB8BB1B 


B1B88B61 


(2) 


11BB1B11 


EOR 


B11B18B1 


16168818 




rllllBBBB 
kUllBBBB 


AND 


B1BBBBBB 


81B88BB3 


CD 


EOR 


1B11B888 


B16BB888 


C2) 


rBlfllBlBl 
L B1B1B1B1 


ORA 


1B1B181B 


11111111 


CD 


EOR 


1B1B181B 


11111111 


C2) 


11B816BB 


EOR 


1B11B18B 


81111188 




rllllllll 
Hlllllli 


AND 


1111B881 


11118881 


CD 


EOR 


BBBB1118 


1111BBB1 


C2) 


BB1BB1BB 


EOR 


1BB111BB 


1B11186B 




eiBBBlll 


EOR 


B1B18B11 


88818616 





Simple Multiplication 

As you may recall, by shifting a binary 
number left one bit, we effectively multi- 
ply it by two. Shifting it left two bits multi- 
plies it by four. This principle is very handy, 
allowing us to multiply integers quickly and 
easily. 

How do we perform this left-shift opera- 
tion in 6502 assembly language? With the 
ASL (Arithmetic Shift Left) instruction, of 
course. This operation shifts the contents 
of the accumulator or a selected memory 
byte left one bit, and has the following 
formats: 

ASL A (ACCUMULATOR) 

ASL nn (ABSOLUTE) 

ASL n (ZERO PAGE) 

ASL n,X (ZERO PAGE INDEXED X) 

ASL nn,X (INDEXED X) 

When an ASL instruction is executed, the 
accumulator or memory byte is shifted one 
bit to the left. Figure 2 shows how the oper- 
ation is handled internally. 



before a Qllaa II 


CARRY BYTE=49 


AFTER [|*8lIil8GlB<"e 


CARRY BYTE=5B 



As you can see from the "before" and 
"after" images in Figure 2, each bit of the 
selected byte is shifted to the left one place. 
Since Bit 8 has no other place to go, it is 
shifted into the 6502 Carry flag. This is 
done to allow for multiple-byte shifts, which 
we'll look at in a moment. A is shifted 
into the 1 bit. As you can see, the value of 
the byte has been multiplied by two! 

As long as the results of your shift- 
multiples do not exceed 255 decimal, you 
will find the ASL instruction works fine. 
Problems begin, though, when you get into 
multiple-byte values. 

Figure 3 shows an example of a multiple- 
byte shift. As you can see, the contents of 
Bit 7 of the low byte must shift into Bit 
of the high byte. In order to do this, we must 
see the LSR instruction to shift the low byte, 
and a new instruction, ROL (Rotate Left 
through carry), for the high byte. ROL has 
the following formats: 



BEFORE 



00110180 10011118 



00. 



VALUE = 13478 



AFTER 




011018 



W 




0i<-0Qiiii88<-0 



UE = 26340 



I 
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ROL A ACCUMULATOR) 

ROLnn (ABSOLUTE) 

ROLn (ZERO PAGE) 

ROL n,X (ZERO PAGE INDEXED X) 

ROL nn,X (INDEXED X) 

The ROL instruction performs the same 
function as ASL, except that it puts the con- 
tents of the Carry flag in the low-order bit 
instead of a zero. 

Both ASL and ROL set the Sign, Zero 
and Carry flags according to the result of 
the operation. 

Let's look at a few examples of multipli- 
cation using the ASL and ROL instructions. 



18 


»= $0688 




20 


LDA K$87 


J PLACE 7 IN ACCUM. 


30 


ASL A 


J TIMES 2 


40 


ASL A 


J TIMES 4 


5a 


ASL A 


j TIMES 8 


60 


STA TIMES8 


jSAME RESULT 


70 


BRK 


;AND STOP! 


80 


TIME58 «=M+1 


''■.-: ' • ': X- 


90 


.END 


^BIIIIBhHI 



The above shows an example of single- 
byte multiplication using the ASL instruc- 
tion. In this example, we're multiplying the 
contents of the accumulator (7) by eight and 
storing the result in the location labeled 
TIMES8. 

Line 20 loads the accumulator with 
I the number 7 (00000111 binary). You can 
try different values here to test the mul- 
tiply. Remember that since this is only 
| a single-byte multiply, the result cannot 
exceed 255. Therefore, don't use any 

k values greater than 31 decimal here. 
Line 30 shifts the accumulator to the 
left one bit, multiplying the accumula- 
tor by two. After this instruction exe- 
cutes, the accumulator will contain 14 
decimal (00011110 binary). 

Line 40 shifts the accumulator left an- 
other bit. At this point, the accumulator 
I is four times the starting value of 7, or 
28 (00011100 binary). 
Line 50 shifts the accumulator left a 
S third time, giving us eight times the start- 
ling value, or 56 (00111000 binary). 

Line 60 stores the final value of 56 

I decimal ($38 hex) in the location labeled 

TIMES8. If you change the value in line 

20, the value you enter will be multiplied 

• : by eight and placed in TIMES 8. 

Line 70 stops the program execution. 
Line 80 reserves one byte for the re- 
sult of the multiplication, labeled 
TIMES8. 

The above example shows how easy the 
ASL instruction makes it to multiply a num- 
ber by a power of two, but what if you want 



to multiply a number by five? 

In such cases, it's good to break the mul- 
tiplier down into "bite-sized" pieces. For 
example, a multiply by five can be broken 
down into: 






(NUMBER * 4) 
+ (NUMBER ) 



(NUMBER 



The 6502 code required for this operation 
is shown below. 



18 

15 
20 
25 
38 
35 
48 
45 
50 
55 



*= $0608 
LDA tt23 
ASL A 
ASL A 
CLC 

ADC 823 
STA TIMES5 
BRK 
TIMES5 *=*+l 
.END 



JPLACE 23 IN ACCU 

J TIMES 2 

J TIMES 4 

; CLEAR CARRY FOR ADD 

;ADD 23 = TIMES 5! 

;AND STORE RESULT 

J ALL DONE! 



Similarly, a multiply by ten can be bro- 
ken down to: 



NUMBER 
(NUMBER 



81 
2) 



(NUMBER « 10) 






With its 6502 code shown here: 

18 *= $0688 HHH 

15 LDA 823 JPLACE 23 IN ACCUM. 

28 ASL A J TIMES 2 

25 STA TIMES2 J SAUE *2 UALUE 

38 ASL A J TIMES 4 

35 ASL A J TIMES 8 

40 CLC J CLEAR CARRV FOR ADD 

45 ADC TIMES2 J*8 + *2 = »10! 

50 STA TIMES18 J SAVE TIMES 18 

55 BRK {AND STOP! 

60 TIMES2 *=*+! 

65 TIMES10 *=*+l 

70 .END 

As you can see, you can multiply a num- 
ber by almost any value through a combi- 
nation of left-shifts and add/subtract 
operations. It's just a matter of careful plan- 
ning when writing a program. 

Multi-Byte Multiplication 

Now that we've looked at single-byte mul- 
tiplication, we can go on to bigger and bet- 
ter things, such as multiplying two-byte 
values. The figure below shows the proce- 
dure for multiplying the two-byte value TO- 
TAL by 16. Note that the low-order byte is 
always SHIFTed, and the high byte is al- 
ways ROTATEd. 



to 


Ms 


$0600 








'IS 


LDA 


»$82 


JPLACE 02. . . 






70 


STA 


TOTAL+1 


JIN TOTAL HI 


BYTE 




25 


LDA 


8$4F 


JPLACE 4F.. . 






30 


5TA 


TOTAL 


j IN TOTAL LO 


BYTE 




35 


ASL 


TOTAL 


J SHIFT LOW, 






40 


ROL 


T0TAL+1 


J ROTATE HI = 


TIMES 


2 


45 


ASL 


TOTAL 


J SHIFT LOW, 






50 


ROL 


TOTAL+1 


J ROTATE HI = 


TIMES 


4 


55 


ASL 


TOTAL 


J SHIFT L0H, 






60 


ROL 


TOTAL+1 


J ROTATE HI = 


TIMES 


8 


65 


ASL 


TOTAL 


j SHIFT LOW, 






70 


ROL 


TOTAL+1 


J ROTATE HI = 


TIMES 


16 


75 


BRK 




JALL DONE! 






88 
85 


TOTAL *=#+2 





















Lines 15-30 initialize the variable TO- 
TAL to $024F (0000001001001111) binary. 
Note that the label TOTAL is the low- 
; order byte and TOTAL+1 is the high- 
order byte. 

Line 35 shifts the low byte of TOTAL 
left one bit, multiplying it by two. This 

(operation places the contents of Bit 7 of 
the low byte in the Carry flag so that it 
1 can be shifted into the high byte by the 

I next operation. 
Line 40 rotates the high byte of TO- 
TAL left, placing the Carry flag's con- 
tents in Bit 0. Like the shift operation, 
the rotate places the contents of the high 
byte's Bit 7 in the Carry flag. After this 
instruction executes, TOTAL contains 
$049E (0000010010011110 binary), or two 
times the original value. 
Lines 45-50 multiply TOTAL by two 

I a second time, resulting in a value of 
$903C (0000100100111100 binary), or four 
times the original value. 

Lines 55-60 multiply TOTAL by two 
again, giving a value of $1278 
(0001001001111000 binary), or eight times 
the original value. 

Lines 65-70 multiply TOTAL by two 

a final time, giving a final result of $24F0 

(0010010011110000 binary), which should 

be $024F*16. Checking, we find that 

$024F is 591 decimal. 591 times 16 is 

9456 decimal, or $24F0, and our answer 

in TOTAL is correct. 

These examples show the basics of 6502 

multiplication, but don't stop here. Study 

the above code and try creating your own 

programming puzzles. I've given you the 

ball, now run with it! 

Divide and Conquer 

Now that we've covered simple multipli- 
cation, let's look at basic division. You 
know how bit-shifting works, so picking up 
the finer points of binary division should 
be easy. 

Remember how shifting the value 49 dec- 
imal (00110001 binary) left one bit gave us 
98 (01100010 binary)? What happens if we 
shift the value RIGHT one bit? Figure 4 
gives us the answer. 



before boIIoIoI 


BYTE=*5 CURRY 


AFTER 8+ filial ■*[!] 


BYTE=24 CflRRY 



As you can see, we've just discovered the 



8 



IT 



first limitation of binary division— we can't 
handle decimals! Using real numbers in- 
stead of integers, 49/2 =24.5. Shifting the 
value 49 right one bit divided it by two, all 
right, but we lost the decimal portion of the 
result. We'll look at real-number division 
in later installments of Boot Camp, but for 
now the loss of the precision does not mat- 
ter. I mentioned the problem because it's 
good for you to be aware of this limitation. 
In the 6502 instruction set, the operation 
that performs this right-shift is the LSR 
(Logical shift right) instruction. Its formats 




As Figure 4 shows, the LSR instruction 
shifts all the bits of the indicated byte right 
one position. A zero is placed in the high- 
order, or 128, bit. The low-order, or 1, bit 
is shifted into the Carry flag. This allows 
us to perform multi-byte right-shifts, simi- 
lar to multi-byte left-shifts. 

Before we look at multiple-byte division, 
let's look at a single-byte example. 



10 


*= $8608 




20 


LDA 8184 


;PUT 184 IN ACCUM 


30 


LSR A 


J DIVIDE BY 2 


40 


LSR A 


; DIVIDE BY 4 


50 


LSR A 


; DIVIDE BY 8 


68 


STA DIV8 


;SAVE RESULT 


70 


BRK 


;AND STOP! 


80 


DIV8 *=*+l 




90 


.END 





The above shows an example of dividing 
a single-byte value by eight. Like multipli- 
cation by eight, this operation requires three 
shifts, but in the opposite direction. In this 
example, we divide the number 184 deci- 
mal by eight, placing the result in the loca- 
tion DIV8. 

Line 20 places the number 184 
(10111000 binary) in the accumulator. 

Line 30 shifts the accumulator con- 
tents right one bit, dividing the value 
there by two. After this instruction, the 
accumulator contains 92 (01011100 
binary). 

Line 40 shifts the accumulator right 
another bit, dividing the value by two 
again. At this point the accumulator is 
divided by four and contains 46 (00101110 
binary). 

Line 50 shifts the accumulator right a 
final time, leaving the accumulator con- 
taining the original value divided by 
eight. At this point it contains 23 
(00010111 binary). 



Line 60 stores the contents of the ac- 
cumulator in the locaiton labeled DIV8. 
If you examine this location after the pro- 
gram executes, you will see that it con- 
tains 23 decimal ($17 hex). Checking, 
U you will find that this is 184 divided by 
eight. 

Line 70 BREAKS the program, stop- 
ping execution. 
Line 80 reserves one byte for the val- 
I ue DIV8. 

Now you see how simple single-byte di- 
vision is. If you want to divide any integer 
up to 255 by a power of two, this process 
works fine. 

Shifting Into High 

Up till now, we've limited ourselves to 
simple, single-byte division. Now let's see 
how we do it with more than one byte. 

Figure 5 shows the division of the two- 
byte value 28008 by two. As you can easily 
calculate, the result is 14004. If you com- 
pare this example with the multi-byte mul- 
tiplication shown in Figure 3, you will 
notice an interesting difference. 



BEFORE 


ell bIU o 


i BilgieBB 


UflLl 


E - ZoBOo 
AFTER 


B-+ o ¥T I HT 


lB-UBiiBiBB 


UA 


LUE = 14BB4 



In multiplication, the low byte is shifted 
and the high byte(s) is (are) rotated. This 
is because the bit-shift proceeds from right 
to left. 

In division, however, things are reversed. 
Since we are shifting all the bits to the right, 
the highest byte is shifted and the remain- 
ing bytes are rotated. This allows the low- 
order bits of the bytes being divided to shift 
into the lower-order bytes. 

Let's look at an example of the three-byte 
value SCORE being divided by four. The 
code necessary is shown below: 



18 


*= 


$8688 


J SET UP. . . 


15 


LDA 


t»$49 


28 


STA 


SCORE+2 


J3-BYTE. . . 


25 


LDA 


»$23 


; VALUE. . . 


30 


STA 


SCORE+1 


;IN SCORE, . , 


35 


LDA 


tt$F8 


;= S4923F8 


48 


STA 


SCORE 


- 


45 


LSR 


SCORE+2 


; DIVIDE. ., 


58 


ROR 


SCORE+1 


; SCORE. . . 


55 


RDR 


SCORE 


JBY 2 


68 


LSR 


SCORE+2 


j DIVIDE. . . 


65 


ROR 


SCORE+1 


J SCORE. . . 


78 


ROR 


SCORE 


JBY 4 


75 


BRK 




JAND STOP! 


88 


SCORE *=*+3 




85 


.END 





Lines 15-40 initialize the three-byte val- 

■ ue SCORE to S4923F8. Remember that 
multi-byte values are always stored in 
low-byte/high-byte order. In this case 
SCORE is the lowest-order byte and 

1 SCORE+2 is the highest-order byte. 

Line 45 shifts the highest-order byte 
of SCORE right one bit. The 1-bit of 
SCORE+2 is placed in the Carry flag, 
ready to be rotated into the next byte of 
SCORE. 

Line 50 rotates the middle-order byte 
right one bit. The bit carried from the 
H highest-order byte is shifted into 
SCORE+1's 128-bit, and the 1-bit of 
SCORE+1 is placed in the Carry flag for 
the next rotate. 

Line 55 rotates the low-order byte of 
SCORE right one bit. Once again, the 
Carry status is placed in the 128-bit, and 

■ the 1-bit is shifted into the Carry. This 
U final Carry is not used, but is ignored. 

After this instruction executes, the val- 
jlue in SCORE is divided by two and con- 
jj tains $2491FC. As an exercise, you can 

calculate the binary and decimal values. 

Lines 60-70 perform the same func- 

Btion as Lines 45-55, leaving SCORE with 

■ the original value divided by four, or 
$1248FE. Calculate the decimal and bi- 
nary values for this result, and you will 

;; see that the original value has been divid- 
ed by four. 

Line 75 BREAKS the execution of the 
• program. At this point, you can exam- 
ine the three bytes of SCORE and see 
that they contain the proper result. 

Line 80 reserves three bytes for the 
variable SCORE. 
Well, now you have the basics of integer- 
binary multiplication and division under 
your belt. The principle is simple; you just 
have to work with it until you feel comfort- 
able. In order to do that, create your own 
problems to solve. 

Here it Conies 

For those of you who need some prompt- 
ing to get started with problems, here's one 
that shouldn't be too hard if you've read 
carefully. 

Write a program that multiplies the val- 
ue 5 by 27. Use any of the techniques we 
have discussed so far. There are several pos- 
sible solutions to this problem, so give it 
your best shot. 

Next issue, we'll look at a couple of pos- 
sible solutions. We'll also find out what the 
stack is and how it helps us write 
subroutines. 
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Captain Fizz 

Meets the Blaster-Trons 

IPsygnosis, Ltd. 
Distributed by Computer Software Service 
2150 Executive Drive 
Addison, IL 60101 
(800) 669-4912 
$29.95; Color only 



Captain Fizz, an arcade adventure, is another 

of Psygnosis' independently 
produced titles, released under the 
Psyclapse label. The single-disk 
program, packaged in the familiar 
square hard case, is accompanied 
by a six-page mini-manual entitled 
The Queen's Cloned Highlanders 
Regimental Handbook. The player 
assumes the role of a cloned sol- 
dier who must journey from level 
to level inside the starship Icarus 
with the ultimate goal of knock- 
ing out the craft's main computer. 
In the best tradition of HAL, the 
berserk computer of 2001: A Space 
Odyssey, the computer aboard the 
Icarus has gone haywire, and the 
ship is hurtling uncontrollably to- 
ward the sun. 

Captain Fizz is a simultaneous 
two-player split-screen contest. 
(One person can play alone, but is 
warned that it will be impossible 
to win.) The right and left sides of 
the screen are filled with status 
readouts that will be mostly gib- 
berish until the game's learning 
curve has been crested. The nu- 
merical readouts at the left display 
the player's score, personal health, 
armor (how well-shielded from 
enemy weapons he is), damage 
(how destructive his blaster is), 
charge (how many times his ulti- 
mate weapon can be used), credit 
(points earned that can be ex- 
changed for other things) and 
cards (keys used to unlock color- 
coded doors). 



Also, a vertical meter indicates 
how much energy is left in the 
blaster. Green is the safe level, but 
if the power should drop into the 
red, Captain Fizz is in mortal dan- 
ger. After his energy is complete- 
ly expended, the player is virtually 
impotent. 

These readouts limit the size of 
the playfield. Consequently, the 
ST's animated sprites are so small 
that it becomes difficult for two 
players to sit close enough to the 
screen to be able to make them 
out. The ST can be hooked up to 
a television via the RF modulator. 
This might be a good idea in or- 
der to keep eyestrain to a 
minimum. 

Because the game's sprites are 
so tiny and are viewed from above, 
there is little animation. The main 
characters move their arms and 
legs, but this can just barely be 
seen. With two humans connect- 
ed to the computer via separate 
joysticks, Captain Fizz shows no 
tendency (except in one minor 
case) to bog down in its execution. 
With so many droids running 
around loose in the Icarus, it's nice 
to see that the game stays up to 
speed. 

The function keys allow for 
some configuration of the game. 
F1/F2 select player 1 or 2. F3 
pauses the game. F4 is supposed 
to restart the game, but this does 
not work as most gamers would 
expect it to. F5/F6 allow players to 



commit suicide, a surefire restart 
function. F7/F8 detonate a smart 
bomb. F9/F10 are difficulty levels. 

Sound plays a major role in un- 
tangling Captain Fizz's adventure- 
type web. The many sound effects 
are easily distinguishable; howev- 
er, it's quite a trick to identify an 
accomplished objective by audio 
signals alone, especially since the 
documentation says nothing on the 
matter. 

Various icons give the players 
extra powers. The blue icons 
marked with an "A" add to your 
personal armor. The "gun" icons 
increase the damage you can in- 
flict. The dynamite icons give the 
player the ability to use a "blitter 
bomb," which destroys all enemy 
weaponry on the screen. 

Not only is each game timed, 
but a player is allowed to continue 
only as long as his health readout 
stays above zero. In order to stay 
in play as long as possible, a play- 
er is allowed to exchange earned 
credits for improvements in per- 
sonal status. 

To save you some frustration, I 
offer the following hint: At the 
right side of the screen is a four- 
LED readout labeled "Switches." 
Each LED must be lit in order to 
disable a force field for a limited 
period of time. The player must 
have already destroyed all of the 
"L" icons (I'm still not sure what 
the "L" stands for). When this has 

(CONTINUED ON PAGE 59) 
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Changing Patterns is billed as 

an "art and idea generator." But 
this collection of four disks 
presents many electronic 
"Spiro-Graph" simulations, 
many of which can be varied 
with keyboard inputs by the 
user. Hard-copy and file-save 
features provide some creative 
outlets besides the show seen 
on the monitor as the designs 
are drawn. 

Disk one contains the main 
program for Changing Patterns, 
referred to as CP. It also pro- 
vides a "pre-menu" that serves 
as a gateway to the other disks, 
each of which may be booted 
separately as well. After 
presenting the title and revision 
screens, CP delivers the primary 
Changing Patterns main menu. 
To get an idea of what this pro- 
gram is about, selecting the self- 
generating function sends con- 
trol to the "self-generating" art 
program, the main creativity 
module of the CP package. 
Selecting the Execute option im- 
mediately musters an interesting 
display of diamonds. As they are 
drawn, console- and keyboard- 
key presses change the size, 
shape, colors, margins and 



numerous other features of the 
design. 

Multiple columns of objects, 
such as hexagons, 3-D per- 
spective boxes, octagons and 
lines are created with this 
module. The sizes and overlap- 
ping of the objects create many 
different, sometimes hypnotic, 
patterns. Certain controls ap- 
plied during the creation of the 
art add an asymmetric twist to 
the screens. A particularly fas- 
cinating design can be saved to 
a temporary file by pressing all 
the console keys— Start, Select 
and Option— simultaneously. 

Once a masterpiece is creat- 
ed and saved, CP is used to 
load the picture and print it. 
Only Epson and Star Micron- 
ics Gemini printers are sup- 
ported. CP defaults to "none," 
instead of Epson, which re- 
quires the user to specify a 
printer every time the CP is 
run. The manual recommends 
using some advanced graphic- 
printing utilities, such as those 
from Alpha Systems. 

CP does a good job of gener- 
ating a quick plot of a design 
at the top-left of a page of pa- 
per. This is ideal for folding the 
page lengthwise, then width- 
wise, to create a nice-looking 
greeting card, ready to be filled 
in by hand on the inside. This 
is probably the most practical 
use of Changing Patterns. Its 
ability to save screens allows 
the user to make use of some 
interesting design results in 
other programs, with some ad- 
ditional programming efforts. 
The second disk is called the 
Exploration Disk. It contains 34 
separate short graphics pro- 
grams, all tied together by a 
main menu. Each has a 
"canned routine" for creating 
the art. Some create intricate 
tile work or pictures, very 
much like those done with a 
child's Spiro-Graph. Any pat- 
tern is easily saved to disk for 



later viewing and plotting with 
the main CP module. 

All the programs are written 
in BASIC and are unprotected. 
This allows the user to back- 
up the files, as well as study 
and learn from them. The pro- 
grams work well overall, but I 
did crash one of the Explora- 
tion programs while adjusting 
the size of the patterns. Be- 
cause all the software is in BA- 
SIC, the pattern-generation 
process itself can be tedious at 
times. The manual documents 
many different "macro-key" 
commands that are employed 
by the various art modules. 

The third disk is the Help disk. 
It is a nicely detailed tutorial that 
helps the user through some of 
the more esoteric macro func- 
tions. The manual also provides 
a short tutorial that contains a 
series of step-by-step exercises 
to create some pictures and help 
teach the menu and macro-key 
functions. 

The manual, nearly 50 
pages, is complete, with many 
details. It is not well organized, 
however. The hardest part of 
using the manual is locating 
the right set of macro-key 
commands for each art 
generator. 

Changing Patterns is not a 
spectacular program, but it will 
provide a lot of interesting ar- 
tistic interaction with the com- 
puter on those rainy days. Its 
inconsistent user controls pro- 
vide for a bit of adventure in 
experimenting with cause-and- 
effect. When it comes time to 
get caught up with letter writ- 
ing, the printouts make nifty lit- 
tle greeting cards. There are 
infinite designs to be discov- 
ered with Changing Patterns. 




Matthew Ratcliff, a frequent 
contributor to ANALOG 
Computing, lives in St. Louis, 
Missouri, with his wife and 
two children. 
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MT-32 Controller 



Reviewed 

by 

Michael Friesen 

What defines a useful piece of 

software? That's a good question 
to throw onto the bulletin board 
next time things get boring. The 
MT-32 Controller from Polysoft 
prompted me to ask myself this 
question. For although the program 
does some genuinely useful things, 
it has enough idiosyncracies to oc- 
casionally hamper the music- 
making process. 

This is a desk accessory, but 
you may want to beware of what 
kind of software you team it up 
with. Because the program grabs 
many interrupts, you might find 
that some screen functions are 
slower than normal. Programmer 
David Barr assures me that se- 
quencer timing is not affected. 

Along with the main program 
are three additional files. The first 
two are banks of 64 sounds. The 
other file is a "translibrarian," 
which allows you to load (from 
disk) and store (to synth) banks of 
sounds. This program is compati- 
ble with any synth supported in 
the Controller series: Roland's 
D-110, MT-32, Yamaha TX81Z and 
FB-01 and the Kawai K1. 

The program is not copy pro- 
tected and must be installed in the 
root directory of your boot drive. 
It will run either in medium or in 
high resolution. 

The program's functions can be 
divided into two distinct areas: 
patch librarian and front-panel ex- 
pander. Both functions reside on 
a single screen. 

The Front Panel 

The panel expander is where this 
program scores most of its merit 
points. The expander takes up the 
left-hand portion of the screen and 
gives you quick and easy access 
to Master and Part controls. 

Reverb, pan, trigger mode and 
fine-tuning are some of the 
parameters this program gives you 
access to. Even though many of 
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the parameters are already avail- 
able from the front panel of the 
synth, it's nice to have them all laid 
out in an easy-to-see format. 

Parameter values are changed 
by left-clicking on Up or Down ar- 
rows to either side of a parame- 
ter. Left-clicking inside the 
parameter box sets the value to a 
sensible default. If you're ac- 
customed to a quick mouse, you 
may have to reset the speed to 
fine-tune some of the parameters. 
Sometimes it's hard to stop the 
mouse just at the value you want. 

The Right Stuff 

The right mouse button is put 
to good use. Clicking on the right 
button gates the sound selected 
for the current part. Holding the 
button down sustains the sound, 
and removing your finger from the 
button starts the release cycle. 

Here's the neat part: Pitch and 
velocity are determined by y and 
x positions of the mouse. Right- 
clicking while the pointer is in the 
upper-right corner will gate a high- 
pitched note at a high velocity. 
Lower-left will give you a note 
with a low pitch at a low velocity. 
This is a great idea, since it makes 
use of the oft-ignored right button. 

Librarian? 

Whatever the ads and the pack- 
aging might say, this is not a patch 
librarian. It simply does not con- 
form to the standards of what a 
patch librarian can reasonably be 
expected to do. 

On the good side, the program 
will give you access to both banks 
of ROM sounds (the presets), as 
well as one additional bank of 64 
sounds. Each bank is displayed as 
a whole, all 64 patches at a time. 
Even though the font is necessar- 
ily small, it's nice to be able to pick 



from 64 on-screen sounds. 

New sounds can only be load- 
ed into the MT-32 Controller if the 
file of 64 sounds has already been 
saved in the Controller's unique 
format. And it is impossible to 
swap sounds between banks. 
These two factors weigh heavily 
against the program. Here's why: 

You can only get new sounds into 
the Controller if they have already 
been saved in the proprietary for- 
mat. If you buy a bank of sounds, 
they will either need to have been 
saved in Controller format, or you'll 
have to find a way to send them 
to your synth. Once the sounds are 
resident in the MT-32, you can use 
the Retrieve function to get the 
sounds into the Controller and then 
save them to disk. 

This means that, unless you're 
content to play around with the 
two new banks and the two banks 
of presets, you'll need to buy a 
patch editor or librarian before you 
can start messing around with 
more sounds. 

And because you can't shuffle 
sounds between banks (or even 
within a bank), there's no way to 
remap sounds or create perfor- 
mance banks. You'll need to buy 
a patch librarian to be able to do 
that. 

The Sound Banks 

The two new banks of sounds 
supplied with the program repre- 
sent the usual mix of weird effects, 
the requisite attempts at a piano, 
some nice strings and a few ab- 
solute killers. My own favorite is 
the Rock Organ patch in the D50 
bank. 

Some of the sounds appear to 
be either misnamed or have had 
their data grossly scrambled. All in 
all, though, they're a nice addition, 
giving the user an alternative to 



ROM presets. 

The Bottom Line 

It's hard to pin down exactly 
where this program should fit into 
the scheme of things. The Mas- 
ter and Part controls are useful, 
but at least partly duplicated on 
the front panel of the synth. And 
the librarian can only deal in terms 
of whole banks of patches that 
have been stored in the Con- 
troller's proprietary format. Unless 
your librarian is a real monster, 
which won't work as a desk ac- 
cessory, the librarian side of the 
program hasn't got a lot to offer. 

Given the kind of stiff competi- 
tion on the market, even a $50 pro- 
gram should meet certain levels of 
performance. Yet this program has 
no printing, no ability to assemble 
custom banks, and leaves you 
stuck with that proprietary file for- 
mat, requiring you to have anoth- 
er patch editor or librarian before 
you can do any serious work with 
your synth. 

In strictly economic terms, this 
program doesn't offer enough to 
justify its price. Fifty dollars is too 
much to pay just to access a few 
new functions. 




Michael Friesen has worked as 
a bookbinder, a chicken-shed 
cleaner, a cow milker, a ditch- 
digger, a jingle composer and a 
synthesist for a touring theatre 
company. A MIDI fanatic, he likes 
to annoy retailers by asking them 
about products that haven't yet 
been released. 
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Airball is a fascinating three-dimensional 

graphic adventure for one player, 
with superb graphics and enter- 
taining musical sound effects. It is 
one of the few games Atari has 
released recently, with a copyright 
of 1987 by Microdeal. 

The instruction leaflet does not 
provide much detail, other than the 
basics of game play. It seems you 
have upset an evil wizard. No one 
knows exactly why, but he is so 
angry that he conjures, "Mortal 
human, weak and small, turn into 
a bouncing ball." Poof! 

Your goal, as a deflating ball, is 
to navigate the evil wizard's man- 
sion to recover his spell book. 
There are more than 150 peril- 
filled rooms to search. What's 
worse, the wizard has given you 
a slow leak. Scattered about the 
labyrinth of rooms in the mansion 
are air pumps. Whenever you are 
nearly flat, you must bounce upon 
one so it can pump you up. Wait 
too long and the ball explodes in 
a shower of rubber. You are given 
only four balls to complete the ad- 
venture, so you need to learn 
where the pumps are. 

Each room and hallway is 
viewed from above. The rooms are 
tilted and rotated at a 45-degree 
angle. This makes joystick control 
confusing at first, as is typical with 
all games of this type. I found that 
turning my joystick 45 degrees to 
the left made it much easier to 
navigate the rooms. 

The rooms are finely detailed, 



with excellent perspective and 
shading for a nice illusion of depth. 
The floors and walls appear to be 
made of a brown sandstone. The 
floors are tiled; the safe paths are 
smoothly colored. Some tiles are im- 
pregnated with lethal spines, which 
you must roll around or hop over. 
Wicked spikes protrude from the 
floors in nearly every room. Bounc- 
ing on any of these spikes is cer- 
tain destruction. Staircases, which 
are easy to roll down or bounce 
up, can be found in many rooms. 

The total number of air balls re- 
maining is shown at the bottom- 
left of the game screen. The score 
is at the bottom-right. In the cen- 
ter is a horizontal bar that acts as 
a gas gauge for total air remain- 
ing in the ball. When you hop on 
an air pump, this line increases. 
You must hop off before overinflat- 
ing and bursting. 

Each room has at least one en- 
trance and exit, depicted as a 
stone archway. As you progress in 
the game, it is wise to draw a map. 
Some rooms require instant selec- 
tion of the proper move upon entry. 

Along the way you will encoun- 
ter, scattered about the mansion, 
precious stones and gold bricks, 
which may be exchanged for 
points. Apparently, the wizard is 
following you closely and dropping 
these valuables as he goes. Some- 
times, you will enter an empty 
room, exit and immediately re- 
enter it to find more gold. This is 
entirely random, so you must keep 



a sharp eye. 

There are also special objects, 
essential to progress and ultimate 
completion of the game, that must 
be collected along the way. For ex- 
ample, some rooms are dark and 
thus unsafe to travel without prop- 
er lighting. You must gather the 
wizard's candle before you can 
safely enter this kind of room. Var- 
ious obstacles are impassable until 
you move some crates into a po- 
sition that allows you to safely 
bounce over them. 

Strategy is important in Airball. 
Only one object can be carried at 
a time. As you learn the mansion's 
mazes, planning where to place 
these objects for most efficient 
progress is vital. 

Airball will provide many hours 
of addictive fun. The graphics de- 
tail, depth, payability and musical 
effects reinforce the fact that the 
8-bit Atari is an excellent game- 
playing machine. Its only flaw, due 
to the fact that it is a cartridge 
game, is that you cannot save a 
game in progress. My hat is off to 
Atari and Microdeal for bringing 
such a fine and timely video game 
to the Atari XL/XE/XEGS com- 
puters. Note that Airball is not 
compatible with older Atari 
400/800 computers. 



The author wishes to thank 
Randall's Home Computers of St. 
Louis, Missouri, for their valuable 
assistance in preparing this review. 
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Figure 1: The opening 
scene from a Talespin 
adventure. When the 
player moves the mouse 
over text that can affect 
the progress of the 
game, the text is high- 
lighted. Text balloons 
that cannot affect the 
course of the game have 
the same background at 
all times. The mouse is 
represented here by a 
stylized pointer in the 
lower right-hand corner 
of the text window. 




The development of my in- 
terest in creating programs 
did not coincide with a will- 
ingness to spend the time it 
takes to learn a programming 
language. I was looking for 
easier, faster results, so I or- 
dered a public-domain disk 
containing an "adventure cre- 
ator." This program, as it 
turned out, was difficult for 
a novice to use and the prod- 
uct it created was a simple 
text adventure, whereas I 
wanted my programs to make 
ample use of graphics. I final- 
ly admitted that there were 
no shortcuts, loaded up ST 
BASIC and plodded away. 
With the help of an excellent 
little book, Write Your Own 
Adventure Programs for Your 
Microcomputer (by Jenny 
Tyler and Wes Howarth, Us- 
borne Computer Books, Tul- 
sa: EDC Publishing, 1983), I 



Figure 2: STAC's product has a more 
traditional adventure format. The text 
bar at the top of the screen is provid- 
ed automatically by STAC, but may be 
eliminated if the programmer doesn't 
want it. Most of the rest of the top por- 
tion of the screen can be filled with a 
picture. The text shown is in the default 
font, but other fonts can be used. 
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and a small bridge crosses it. A 
small stone building is to the west. 
what now ? west 

Vou have entered the v i I I age 

I i brar y . Books are arranged on 

shelves throughout the room. The 

librarian is very friendly. The door 

is to the east . Vou can at so see a 

book. 

What now ? get book! 



Figure 5: Talespin's main 
menu and submenus are 
mouse-controlled. 



Figure 6: Each of these images is a 
duplicate of the original, shown at the 
left. The left-to-right orientation of the 
goat on the right has been reversed. 
The goat in the middle is reduced in 
size. Different colors are used for the 
clothing of each copy, and the goat at 
left has a darker coat. 
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did write an adventure game 
in ST BASIC. 

Lately the ST magazines 
have contained ads with lines 
like these: "Adventure-game 
writing made easy!" and "Re- 
quires no programming 
skills!" The ads promote two 
very different graphics/text 
adventure game-creation pro- 
grams. Since this was pre- 
cisely the kind of application 
I had yearned for before 
learning to program, I was 
intrigued. Would these pro- 
grams have met my needs 
two years ago? Would they 
allow a non-programmer 
to produce high-quality 
products? 

The two programs, Tale- 
spin and STAC, do create 
graphics/text adventures, but 
there are many differences 
both in the products they cre- 
ate and in the means by 
which these products are de- 
veloped. 

Talespin, "An Adventure 
Game Creation Program," dis- 
tributed by MichTron/Micro- 
deal and written by Mark 
Heaton, creates a mouse- 
controlled program. Graphics 
are absolutely essential to the 
use of the product, as the 
player must click the mouse 
on a graphic before any con- 
sequence (appearance of text, 
movement to another screen, 
appearance or disappearance 
of graphic images, playing of 
digitized sound) can occur. 
Text is displayed in tiny type 
in Talespin's own unique win- 
dows. Once text is displayed, 
the user may also be able to 
click on the text in order to 
make choices that yield 
specified results. The Talespin 
programmer determines 
whether or not clicking on a 
particular graphic will cause 
any results. For example, in 
Figure 1, an opening scene 
from a Talespin adventure is 
shown. As the scene begins, 
clicking on the kids will have 
no effect. Clicking on the 
mother goat will cause a text 
balloon to appear. Clicking on 



that text balloon, in turn, 
changes the value of a varia- 
ble. If you click on the kids at 
this point, text balloons will 
appear for each of them. 

STAC, "The Atari ST Ad- 
venture Creator," distributed 
by Terrific Software and writ- 
ten by Sean T, Ellis, creates 
a more traditional graph- 
ics/text adventure. Graphics, 
if desired, can occupy most 
of the top half of the screen, 
and text is displayed below it. 
Responses by the player are 
typed; the mouse has no role 
in game play. Graphics are 
used merely to enhance the 
player's understanding of the 
text. A cursor (of adjustable 
style) shows the player 
where the next letter he 
types will appear. 

Products created with both 
programs can be distributed 
in runtime versions, so that 
they may be used by people 
who do not own the respec- 
tive development package. A 
STAC program can be saved 
as a .PRG file; the data unique 
to the STAC programmer's 
adventure is saved to a INK 
file and the needed program- 
ming instructions are saved 
in a .PRG file. Double-clicking 
on the .PRG causes the com- 
puter to automatically load 
the related data and begin the 
game. 

To run a Talespin program, 
the user loads the public- 
domain runtime module, 
TELLTALE.TOS, and then 
selects the data file from 
Telltale's menu. Use of 
Telltale's short menu is not 
difficult to learn. In Talespin 
programs, there is a major 
delay right before the display 
of a new graphic or the trans- 
fer to a new page. This oc- 
curs even when the 
computer does not need to 
read information from disk, 
and it annoyed all of my play- 
testers at least a bit. Products 
created with both programs 
can occupy more than one 
disk. The player's place in the 
game can be saved to disk. 



Both Talespin and STAC 
can be used to create a slick, 
professional-looking program. 
While STAC's literature pro- 
motes its use only for the de- 
velopment of adventure 
games, it is worth noting that 
Talespin's author recom- 
mends other uses for the pro- 
gram, including service 
manuals and educational 
Hypercard-like files. Indeed, 
this reviewer has used 
Talespin to create an adven- 
ture game, a catalog, a 
sound-recognition program 
and even a somewhat suc- 
cessful matching game. 
Talespin is suitable for many 
kinds of applications in which 
graphics and text must be 
linked. 

Adventure games are 
mapped out in "rooms," 
which may or may not rep- 
resent actual rooms indoors. 
An adventure game is really 
a kind of database. There is 
a filing system that keeps 
track of the contents in each 
room, the connections to oth- 
er rooms, the graphics used, 
room descriptions, etc. The 
program keeps track of a va- 
riety of conditions— and of 
the results to be executed if 
those conditions are met. For 
example, if the user chooses 
to "Go north" and a connect- 
ing room is to the north, the 
program will move the user 
to the connecting room. 

A great deal of planning 
must be done before the 
adventure-creation program 
is finally loaded to begin ac- 
tual development. Adventure- 
game development does not 
lend itself to the kind of seat- 
of-the-pants programming to 
which I am accustomed, but 
both programs do allow for 
changes in a basic plan, once 
it is in place. Both the STAC 
and Talespin packages pro- 
vide sample adventures to 
play, and the manuals lead 
the programmer through the 
development of another 
sample. 

Both programs come with 



a paperbound manual and 
two disks. STAC's manual is 
bound with staples through 
the spine; it lays open on your 
table while your hands are 
busy at the keyboard. Tale- 
spin's manual is "perfect-" 
bound (a misnomer if ever 
there was one) and will not 
stay open to a particular page 
unless you break the spine. 
Neither manual is as helpful 
as it should be. 

The STAC manual's 72 
pages are crammed with tiny 
and faint text. The sample 
type-in program is clearly 
presented, but the presenta- 
tion is interrupted by chap- 
ters dealing with the 
command set, the graphics 
editor and the music com- 
mands, making it difficult to 
pick up where you left off. 
The sample adventure is text- 
only, so the reader is not led 
through the process of adding 
graphics to a preplanned ad- 
venture. The chapters are 
otherwise well organized, but 
the treatment of some fea- 
tures is weak. There are 
several options in the editor's 
menu in which commands 
can be entered; some types 
of commands are only effec- 
tive when used in a particu- 
lar option. 

The organization and distri- 
bution of the commands in 
the STAC manual is not iden- 
tical to their use in the edi- 
tor. In addition, the listing of 
commands in an appendix is 
by category as presented in 
the book; these categories do 
not necessarily correspond to 
the menu options in the 
editor. Commands are fre- 
quently presented without 
examples of their use within 
the context of the editor's 
menu. For example, the com- 
mand "colour," which deter- 
mines the color values of the 
lower half of the screen, is 
clearly presented and an ex- 
ample is shown, but no infor- 
mation is offered that really 
tells you how to implement 
the command in a program. 
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Figure 3: Development 
of an adventure game 
requires careful plan- 
ning. The manuals for 
both programs have 
helpful suggestions for 
adventure planning and 
design. 
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I finally determined which 
menu option to use for the 
"colour" command by trial 
and error— a process that 
took nearly half an hour. 

The book attempts to teach 
adventure construction and 
design, and some of the sug- 
gestions are helpful. Sample 
flowcharts and maps help 
you visualize adventure con- 
struction. A major complaint 
for me, personally, is the writ- 
ing style selected by the au- 
thor. The instructions are 
friendly, but attempts at hu- 
mor distract the reader while 
the difficult content requires 
concentration. There is no al- 
phabetical listing of STAC's 
commands, and no item-by- 
item presentation of the 
menu choices. The index is 
virtually useless. For example, 
"palette" and "colour palette" 
both refer the user to page 
30, where the color palette of 
the top half of the screen is 
discussed, but the example of 
the "colour" command on 
page 14 is not mentioned. Af- 
ter a series of such ex- 
periences, I learned not to 



bother consulting the index. 

The 133-page manual for 
Talespin has readable type, il- 
lustrating graphics, boldface 
headings and a slightly more 
useful index. The booklet 
contains helpful information 
about planning programs and 
an item-by-item explanation 
of the use of the main and 
secondary menus. The writ- 
ing style is clear and straight- 
forward. A weak link is the 
walk-through demonstrating 
the creation of a sample ad- 
venture. This tutorial does 
demonstrate the use of many 
menu options, but I found 
some instructions confusing, 
and as with STAC, the author 
interrupts the walk-through 
with a brief explanation of the 
drawing program. 

These manuals are of min- 
imal assistance. Fortunately, 
Talespin users will find that 
minimal assistance is more 
than enough to get them up 
and running. STAC users, 
however, should be prepared 
to learn to use the program 
largely by experimentation 
and to spend a great deal of 



time doing so. 

Even if it were graced with 
a top-notch manual, STAC 
would still be by far the more 
difficult program to learn to 
use, but along with that com- 
plexity comes far greater 
control of the finished prod- 
uct. STAC has a huge com- 
mand set. There is a variety 
of commands to link particu- 
lar conditions with particular 
results (if. . .then), to set the 
color palette, to play three- 
voice multi-octave melodies, 
to control movement and ac- 
tions (repeat. . .until, GOTO) 
and to keep track of the val- 
ue of variables. The program 
can generate random num- 
bers for use in determining 
conditions. Variables are 
limited to two values 
(true/false, on/off, etc.). Vari- 
ables, rooms and even 
vocabulary items are as- 
signed a number, and that 
number is used in commands 
to identify the feature. 

A basic vocabulary file, in- 
cluding typical responses by 
the computer ("You can't do 
that!") is provided with the 
program; vocabulary and in- 
structions unique to the pro- 
grammer's own adventure 
can be added to this list. The 
STAC programmer can select 
or design alternative fonts for 
text displays. Even the reso- 
lution of the text portion of 
the screen is under the pro- 
grammer's control: While the 
top half of the screen is al- 
ways displayed in low reso- 
lution, the lower half can 
display 40- or 80-column text 
in the font style of the 
programmer's choice (a neat 
trick), thus accommodating 
lengthy room descriptions. 
The color palettes of the top 
and the bottom halves of the 
screen are manipulated 
separately. 

Nearly all activity in the 
STAC editor is controlled by 
the keyboard. The menu sys- 
tem is complicated, but ac- 
tions within each of the menu 
choices are designed for con- 



sistency, so it isn't terribly 
hard to use. A useful feature 
is the ability to print out in- 
formation from the various 
editor categories; this helps 
you keep track of the num- 
bers associated with vocabu- 
lary, rooms, etc. The most 
difficult aspect of program 
development is the planning 
and entering of condition- 
related commands; this task 
is made no easier by its min- 
imal treatment in the manu- 
al. STAC contains a 
pared-down drawing pro- 
gram, but pictures can be im- 
ported from Neochrome or 
DEGAS. 

By contrast, Talespin is 
easy to use and easy to learn 
to use, but there is a cor- 
responding decrease in con- 
trol of the finished product. 
Talespin provides a mouse- 
controlled development 
menu. Choices from the limit- 
ed command set are select- 
ed by mouse. Talespin refers 
to results to be executed if 
conditions are met as "op- 
tions." I found this terminol- 
ogy confusing. It would have 
helped me in getting started 
if results had been called 
"results" or "consequences." 

One feature I missed was 
the ability to link particular 
conditions to particular re- 
sponses. Talespin allows you 
to say that "if < variable > 
= 1 or if < variable > = 2, 
then play < sound > and go 
to <page>," but it doesn't 
let you say, "(if < variable > 
= 1, then go to <page>) 
or (if < variable > = 2, then 
play < sound >)." This small 
difference decreases the 
programmer's power and 
control considerably; there 
are sometimes ways to get 
around this deficiency, but it 
is nevertheless limiting. On 
the other hand, variables and 
their value limits can be de- 
fined by the programmer, and 
a limited use of probability is 
possible. 

One thing that makes us- 
ing Talespin so simple is that 
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Figure 4: STAC's main 
menu's features are 
selected by pressing the 
corresponding key. 

— MAIN MENU — 
Free Memory 88802? 



Adverbs 

Begin where ? 

Cond i t i oris ( I oca I 

i sk menu 

Font ed i tor 

Graphics 

H i gh pr i or i ty cond i t i ons 

Low pr i or i ty cond i t i ons 

Messages 

Nouns 

Objects 

Printer menu 

Room descriptions 

Spec i a I cond i t i ons 

Toggle screen resolution 

Verbs 

Erase adventure 



■ai><a:» Enter adventure 

Please choose one of the above. 






it allows the programmer to 
name rooms, variables, ob- 
jects, etc., with real names. 
Because the finished adven- 
ture is mouse-controlled, no 
vocabulary file is needed. The 
editor for typing in text to ap- 
pear in windows is straight- 
forward and easy to use. But 
the small font size and its 
style cannot be altered. 

A major weakness of 
Talespin is that sound is only 
possible through the use of 
ST Replay or Replay 4 (also 
from MichTron/Microdeal) 
digitized sound files. (You can 
also import prerecorded 
sounds from another Talespin 
adventure.) This is a nice en- 
hancement to an adventure, 
but unfortunately, even short 
.SND files take up huge 
amounts of disk space and 
memory. I would like to have 
been able to access the ST's 
sound chip more directly, as 
in BASIC. If an upgrade to 
Talespin is produced, I hope 
it will provide the ability to 
play simple melodies without 
undue use of memory, just as 
STAC does. 

Talespin automatically adds 
changes to the adventure file 
on your disk as they are 
made, a real convenience for 
a programmer. It is, of course, 
also possible to save the file 
under a new name. 

Graphics are important to 



the success of Talespin ad- 
ventures, and the creation 
program provides many use- 
ful features to allow the 
programmer to make the 
most of whatever graphics 
are available. Each object on 
the screen (for example, each 
of the kids, the mama goat 
and the door in Figure 1) is 
controlled separately in mem- 
ory. A background color is 
chosen, and when loading a 
picture, whatever is not part 
of the background is consid- 
ered by the computer to be 
part of the object. 

Objects can be readily 
repositioned. Their position 
relative to each other is ad- 
justable; with a few clicks of 
the mouse, the programmer 
can place one object behind 
another and in front of yet 
another. 

A different color palette 
can be used for each page, if 
desired. Multiple versions of 
the same object can appear 
on the same screen, and yet 
they can each be changed so 
much that the player is not 
aware that they are actually 
duplicates of the same image. 
For example, a duplicate can 
be made shorter (or narrow- 
er) than the original image, or 
the left-to-right orientation of 
the duplicate can be 
switched, or colors used in 
the object can be swapped 



for other colors. 

Since text appears only in 
windows, graphics may fill 
the entire screen, not just the 
top half. A simple drawing 
program is provided within 
Talespin, and graphics can be 
imported from Neochrome, 
DEGAS or another Talespin 
adventure. The drawing pro- 
gram is suitable for touching 
up graphics. 

Talespin is not copy- 
protected, and it runs from a 
hard drive. STAC, on the oth- 
er hand, is heavily copy- 
protected. The particular 
copy-protection scheme used 
prevented the disk from run- 
ning on my Mega ST4. This 
is the first experience I have 
had with copy protection of 
development software, and I 
was shocked. This plan may 
prevent the program from be- 
ing pirated, but it also pre- 
vents legitimate users from 
enjoying the benefits of their 
purchase. When I've used the 
phrase "STAC programmer" 
in this article, I haven't used 
it lightly. Using STAC is 
programming, and it is hard 
work. A programmer with a 
program in progress doesn't 
want to wait six weeks or 
more for the return of a 
working version of his 
damaged development soft- 
ware. Because STAC files can 
grow to be quite large, a 
programmer is likely to want 
to work from a hard drive, 
where multiple saves can be 
easily accommodated. 

STAC isn't cheap, and pur- 
chasers have a right to ex- 
pect a good value for their 
money. Preventing legitimate, 
convenient use of a develop- 
ment package by purchasers 
is, in my opinion, absolutely 
inexcusable. Before purchas- 
ing the program, serious de- 
velopers should consider 
whether they are willing to 
put up with the hassles 
created by STACs copy- 
protection scheme. 

Two years ago I wished for 
a program that would allow 



me to create high-quality 
graphics/text adventures 
relatively effortlessly. Talespin 
does. Talespin can be used by 
almost anyone; certainly chil- 
dren in the later elementary 
grades can learn to use it 
with some adult guidance. It 
has the added advantage of 
having multiple uses, as it 
can create a variety of pro- 
grams linking text and 
graphics. 

The complexity of STAC 
would have precluded my use 
of the program two years ago. 
STAC programmers will ben- 
efit from extensive ex- 
perience with a programming 
language; I definitely would 
not recommend its use by 
novices, especially because 
the manual is so weak. For 
the experienced, STAC does 
have some advantages over 
programming an adventure 
game "from scratch"; these 
advantages must be bal- 
anced, however, against the 
inconvenience of copy pro- 
tection. 

Both of these programs 
can be used to create 
professional-looking adven- 
tures. The products created 
are very different, however, 
and if you have a strong 
preference for one over the 
other, you may want to let 
that be your guide. 

Scenes in the sample pic- 
tures come from public- 
domain programs designed by 
the reviewer. The Wolf and 
the Seven Kids and Barnimals 
were developed with 
Talespin, and Pete's Plunder 
was created with STAC, r 




D.A. Brumleve is a 

programmer who prefers to 
do things the easy way, as 
long as it's easy to learn to 
do things the easy way. 
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Twilight's Ransom 



Paragon Software 
Distributed by Electronic Arts 
1 820 Gateway Drive 
San Mateo, CA 94404 
$34.95; Color only 



Reviewed 

by 

Steve Panak 



Upon loading Twilight's Ransom, you assume 

the role of Ron Mulligan, an artist 
living in Liberty City. This graphics- 
text interactive novel opens as you 
arrive at your girlfriend Maria's 
apartment to find it ransacked. 
Maria is missing. A mysterious 
phone call from the kidnappers 
warns you that Maria will be killed 
unless you deliver the goods by 
sunup. Your first problem is that 
you have no idea just what the 
"goods" are. 

You begin your quest with a 
quick search of her room. Then 
you hit the streets, trying to find 
the clues necessary to reunite you 
and Maria before your time limit — 
and hers— runs out. By the time 
you rescue her, you will have visited 
almost 200 locations and interacted 
with a slew of unsavory charac- 
ters, including prostitutes, con men, 
drug dealers and outcasts. 

Unfortunately, I was disappoint- 



ed upon opening the box— a feel- 
ing that remained unchecked as I 
examined every aspect of the 
package. The three disks that con- 
tain the program, text and image 
files are loaded one at a time into 
your machine, the last two being 
swapped in and out when view- 
ing the pictures— sloppy and an- 
noying, especially when consider- 
ing that all this is to facilitate the 
viewing of only a couple of dozen 
images. Further, the program never 
replaces the desktop with its own 
interface, as the Infocom and Rain- 
bird products do. Rather, your ST 
appears to be running 1st Word in 
low resolution, with scroll bars and 
all. I paid 35 bucks for this? 

Despite this apparent crudity, 
functionally the program works, 
sports a large vocabulary and 
contains vivid descriptions of the 
people and places you visit on 
your search for your beloved Ma- 




Ballistix 



Psygnosis, Ltd. 

Distributed by Computer Software Service 

2150 Executive Drive 

Addison, IL 60101 

(800) 669-4912 

$34.95; Color only 



Reviewed 

by 

Frank Eva 



There seems to be an interest in sports 

games as of late, and Ballistix 
takes advantage of this by adopt- 
ing features from several sources 
and combining them into a new 
genre of indoor sports contests. 
Play mechanics have been bor- 
rowed from hockey and pinball, the 
results resembling a combination 
of Blastaball, one of three games 
from the Awesome Arcade Action 
Pack, and Marble Madness, the 
first coin-operated arcade game to 
be programmed on a 68000-based 
computer. 

The action screen is actually two 
screens connected by a vertical 
scroll that is fast and as smooth 
as silk. The playfield is presented 
in simulated 3-D, with a top-down 
viewpoint that is angled toward the 
human player's goal. Surrounding 
the playfield is a gruesome audience 
and the skulls of would-be Ballistix 
challengers. 

At the beginning of a game, a 
gargoyle slips down from the top 
of the screen and in a resonant 
voice cries, "Let the game com- 
mence!" He exits the screen, and 



from the left, an alien referee drops 
the Ballistix puck into the action 
area. 

The contest revolves around the 
player's ability to direct the puck 
into the opponent's goal. This 
sounds similar to Blastaball, but 
the similarity ends here, for Bal- 
listix has much more to offer than 
the aforementioned title. It's the 
variety of playfields that sets Bal- 
listix apart from other games. In 
the one-player mode there are 50 
playfields, and in the two-player 
mode, 80. 

Once the game commences, 
Ballistix takes on the characteris- 
tics of pinball. There are bumpers, 
pipes, acid pools, troughs, mag- 
nets, hyperspace tunnels, splitters 
and accelerators to contend with. 

The pipes are initially covered by 
sewer grates, but occasionally the 
grates pop open, and if a puck falls 
into the pipe (the fall is also 
represented in simulated 3-D), it will 
reappear from another pipe, located 
elsewhere on the playfield. The 
green acid pools stop the puck in 
its tracks, absorbing it, requiring 
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ria. As long as a disk swap is not 
necessary to view an image, 
response time is relatively quick. 
The only options that are sup- 
ported allow you to save your 
game, control the amount of text 
displayed and turn the images on 
and off. The documentation con- 
tains a number of clues,' but is 
otherwise uninspired. 

All things considered, I cannot 
recommend Twilight's Ransom for 
two reasons. First, it doesn't give 
me what I want to see in a piece 
of commercial software. I would 
expect to see the many shortcuts 
and seemingly halfway-finished 
aspects of this game in public- 
domain software. Which brings us 
to the second problem: the price. 
For two bucks, or the price of a 
phone call, I might like this one. 
But at almost $35, 1 can't help but 
feel ripped off. Steer clear of 
Twilight's Ransom, o 








TWILIGHT'S 



File Text Picture 



Maria lives in a single apartment 
above a tailor's shop which is 
closed for the evening. Vou open 
the door to the right pf _ the 
tailor's shop, and walk into the 



up to naria's apartment. fl sense of 
grin foreboding seizes gou as gou 
notice Maria's door is ajar. as a 
young immigrant girl living alone 
in the big city, Maria is highly 
securitg conscious. She would newer 
leave her door open like this 
unless something was wrong. Vou 
tenselu inhale and . . . . 



Command Line 



the referee to restart the match 
with a new puck. 

One of the finest features of Bal- 
listic is the program's ability to be 
reconfigured by the player. Because 
of this, a player can start out at 
the easiest difficulty level, slowly 
and gradually improving his abili- 
ties as he learns the game, while 
never feeling the frustration inherent 
in so many other sports games that 
have such long and baffling learn- 
ing curves. Unfortunately, there is 
no handicapping feature. Therefore, 
in a two-player game, both contes- 
tants experience the same effects 
when changing the game's config- 
urations. 

At the Level Selection screen, 
many levels of progressive 
difficulty can be chosen. Here, also, 
the choice can be made to play 
against the computer or another 
human. Since this is a simultane- 
ous two-player mode, two joy- 
sticks are required. Pressing the 
space bar brings you to the first 
Options screen. 

Some factors that can be altered 
include ball speed, number of balls 



available and auto-repeat firing level 
(a real thumb-saver). Pressing the 
space bar from the main Options 
screen sends the contestants to the 
second Options screen. (Note that 
at any time, an Options screen can 
be exited by pressing the joystick 
trigger.) 

At Options screen 2, the follow- 
ing features can be configured: ball 
lifespan, accelerator value, num- 
ber of goals to win a game and 
number of games required to win 
a match. 

There are a number of ways for 
a player to improve his score. Icons 
randomly appear that, when hit by 
a ball shot by a human player, award 
bonus points or shields that pro- 
tect the player's goal for a limited 
time. Letter icons can be shot, and 
if the word "ricochet" is spelled, 
10/300 points are added to the play- 
er's total. 

But the most important charac- 
teristic of any game is its ability 
to hold its audience. I'm happy to 
report that Ballistix is a totally cap- 
tivating game, and its price is 
money well spent, n 
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Speedball 



Cinemaware 
4165 Thousand 
Oaks Blvd. 
Westlake Village, 
CA 91362 
(805) 495-6515 
$39.95; Color only 



Reviewed 

by 

Frank Eva 



ST 



is a futuristic combination of sever- 
al popular sports. The game is held 
on a steel playfield with a goal at 
each end and a warp tunnel in 
each side wall. The ball launcher 
rises up from under the floor, ro- 
tates, and then shoots out the 
ball— a solid, stainless-steel rivet- 
ed affair weighing five pounds— 
in a random direction, after which 
any player can retrieve it and put 
it into play. 

Wearing armored uniforms (co- 
vered with razor-sharp spikes), 
two five-man teams compete with 
the intent of scoring as many 
points as possible (while maiming 
their opponents), using a combina- 
tion of speed, muscle and strategic 
employment of power tokens/ 
tiles. 

The players can carry the ball 
or shoot it anywhere on the play- 
field. A fast click of the trigger but- 



ton causes a straight shot from the 
hip, while a longer click results in 
an alley-oop. 

The two-player mode requires 
two joysticks. However, a single 
player can engage in league com- 
petition, and opposing teams are 
drawn randomly by the computer. 

The playfield is smoothly 
scrolled vertically. Each player— a 
larger than usual, outfitted human 
sprite— is viewed semi-top- 
down, allowing superb animation. 

The controllable players are iden- 
tified by a cursor-type pointer. The 
player controlling the ball is iden- 
tified by arrows that point toward 
it from each corner of the cursor. 
It is not difficult to identify the 
sprites that are being controlled. 

If your player does not have pos- 
session of the ball, but is near it, 
pressing the trigger button will 
cause him to jump and attempt to 



catch it. If the button is pressed 
while the sprite is not capable of 
gaining possession of the ball, he 
will attempt to tackle the player fac- 
ing him. This is not quite like foot- 
ball, since there are no fouls and 
no rules; just down-and-dirty fun. 

Tackling is an important game 
dynamic. A successful tackle will 
result in taking control of the ball. 
The stronger the team, the more 
stamina they have against their 
opponents' tackling. When all else 
fails, you can use tokens to cheat 
by bribing the official, the timer, 
the trainer or the referee to gain 
an advantage over your opponent. 

Speedball is superbly pro- 
grammed. The animation and 
game play are astounding, and the 
variations in game mechanics and 
the league options all point to a 
high level of addiction. 

Buy it. a 
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Batman, 
The Coped 
Crusader 



Data East 
470 Needles Drive 
San Jose, CA 951 12 
(408) 286-7074 
$39.95; Color only 



Reviewed 

by 

Steve Panak 



time you read this, the nation will 

have been swept away in a wave 
of Bat-mania. In fact, just today I 
read about the slew of merchan- 
dising products poised to feed 
parasitically on the movie's 
release. Batman, The Caped 
Crusader from Data East is the 
first (but probably not the last) 
computer product based on the 
Dark Knight to cross my desk. 

Batman resides on two disks, 
each containing a classic confron- 
tation between the caped crusader 
and one of his arch-criminal rivals. 
Choose disk one to battle the Pen- 
guin, disk two to match wits with 
the Joker. Regardless which op- 
ponent you choose, the rules of 
play and goals are fixed. Batman 
moves about the city, collecting 
items he needs to quash his ad- 
versary, all the while fighting a 
time limit. At various points in the 



game, you will be challenged by 
henchmen or diabolical traps set 
by the master criminal. Play gets 
progressively more difficult as you 
wind your way through a maze of 
rooms on your way to the final 
confrontation between you and 
your arch nemesis. 

The command interface is a lit- 
tle difficult to master, but performs 
nicely once learned. While you are 
on the main screen, which shows 
Batman in his current location, the 
joystick controls movement along 
all three possible axes. Holding the 
button while moving the stick al- 
lows you to attack with high and 
low kicks and punches. Holding 
the button and pulling back on the 
stick accesses the status screen, 
which displays your lifeline, your 
inventory, and allows you to turn 
off the Batman theme music and 
restart the game. It is also through 



this screen that you get, use and 
drop objects. 

The graphics can't be described 
as anything less than superb. The 
cartoonlike images are mesmeriz- 
ing to watch, with successive 
windows opening as you wind 
through the various rooms. Unfor- 
tunately, I found the puzzles to be 
less of a challenge than was the 
need to complete them in a limit- 
ed timespan. 

One example of a puzzle is the 
necessity of a light to enter a dark 
room. Tougher puzzles are usually 
accompanied by a short clue, 
which helps you hone in on the 
correct strategy. Once the puzzles 
are solved, the rest of the strate- 
gy revolves around two rules. The 
first rule to learn is that picking up 
and eating food increases your 
energy; the second is that a good 
kick to the head or a deftly thrown 
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(CONTINUED FROM PAGE 48) 

been accomplished, a gong will be 
heard. Find the room containing 
four multi colored devices. Touch- 
ing one of these devices while 
pressing the joystick button 
produces a sound effect and acti- 
vates an LED. Repeat the proce- 
dure until all four LEDs are lit and 
then run for the exit. If you fail to 
get there in time, the whole proc- 
ess must begin again. 

As I said, Captain Fizz is proba- 
bly too difficult to win alone. How- 
ever, two players will find 
themselves enjoying the blasting 
of Blaster-Trons and solving the 
game's puzzles. 

Recommended. n 





batarang disposes of troublesome 
hoods. In the end, careful conser- 
vation and timely use of the food 
pellets spell the difference be- 
tween a victorious Batman and a 
dead bird. 

The six-page manual provides 
the basics, although you'll suffer 
from confusion in your first few at- 
tempts as you struggle to decide 
what to do. Actually, the worst 
aspect of Batman is that its two 
single-minded scenarios limit play- 
ability, which I put at only a cou- 
ple of weeks. 

Overall, Batman has merit. Its 
comic book-like graphics do justice 
to the legendary caped crusader 
and it is enjoyable to play. The 
main problem is that once you're 
done with the two scenarios, you'll 
be longing, with nowhere to turn, 
to play Batman again. Oh, well; 
there's always the sequel e\ 
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Steve Panakhas written more 
game reviews for ANALOG Com- 
puting than anyone on the face of 
the earth. He lives in Ohio, where 
he plays games on his ST and, 
with the time remaining, practices 
law. 




In addition to being fascinated by 
computers, Frank Eva is an avid Star Trek 
fan. He has been in terested in computer 
games ever since the release of Pong 
and has written several text adventures, as 
well as some educational game software. 
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teethed on the Atari Assembler/Editor 
(Asm/Ed) cartridge way back in 1982. Now, 
nearly seven years later, it is becoming more 
popular than ever. Why? Well, I have seen 
several mail order ads over the past year 
offering Asm/Ed for only $10, and some- 
times even as little as $5. But there's a hitch: 
no documentation. A lot of Atari cartridges 
were left over from the Warner days when 
the Tramiel family took over the company. 
It seems that thousands of cartridges were 
sold "by the pound," with no boxes or 
documentation, just to clear out the ware- 
houses. Now many of you Atarians have 
decided that Asm/Ed was too good to pass 
up at such a low price, because you just 
know that someday you will learn assem- 
bly language programming. 

This article is for you, the Atarian who 
took the plunge and bought the Asm/Ed car- 
tridge without documentation. I won't pre- 
tend to teach you how to write your own 



assembly language programs (although I'm 
bound to toss in a bit of free advice along 
the way); our Boot Camp series will do that 
job well enough. I hope to give you a quick 
comparison between BASIC and assembly 
language to illustrate the major speed differ- 
ences. I will also cover the mechanics of 
writing a USR routine to help speed up BA- 
SIC programs and a stand-alone assembly 
program that may be executed from DOS. 

The Asm/Ed cartridge will work with any 
DOS (disk operating system) from Atari 
DOS 2.0s all the way through DOS-XE and 
even the SpartaDOS X cartridge. The 
Asm/Ed cartridge itself is made up of three 
basic components: the Editor, Assembler 
and Debugger. I will present a quick refer- 
ence for all the commands of each section 
of the cartridge and then lead you through 
the creation of your first program. 

After booting your Atari with Asm/Ed in- 
stalled and control is sent to the cartridge; 



the EDIT prompt will appear. From here 
you can begin entering your assembly 
"source code" with line numbers, assem- 
bly mnemonics and comments. The editor 
is line oriented, requiring line numbers. 
They are used for reference while editing 
only and are not used as part of the pro- 
gram itself, as they are in BASIC. 

The Editor 

NEW— The NEW command clears all as- 
sembly source code from memory, provid- 
ing a clean slate for entry of a new program. 
NEW will irrevocably erase your program 
from memory, so always be certain to save 
important code before using this command. 
I highly recommend using a comment as the 
first line of every program, similar to the 
following: 

18 ;LIST«l>:U5RTE5Tl.fl5M 

It's easy to forget what file you are work- 
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ing on, or make a typographical error when 
using the LIST command. Saving a file to 
the wrong place can ruin a lot of work in 
a big hurry. By placing the LIST command, 
followed by the correct file name, in a com- 
ment, you may simply display that line and 
use the full-screen editor to eliminate the 
line number and comment character (the 
semicolon), press Return, and execute the 
proper save command every time. This 
good habit has saved me countless hours of 
frustration. Use it! 

DEL— This command deletes lines of 
code. The format is DEL xx, where xx is 
the line you wish to delete, or DEL xxyy, 
where xx is the first line of a block you wish 
to delete and yy is the last line. Example: 
DEL 50,100. 

NUM— Number lines automatically, for 
fast entry of source code. If no starting 
number is specified, the program begins 
with the last line number currently in your 
program, plus 10. Type your code and com- 
ments, pressing Return when each line is 
complete. Press Return on a blank line to 
stop auto-entry of code. Do not use full- 
screen editing functions to change lines 
previously entered while still in the NUM 
mode. This will give unpredictable results. 
The command format is NUM, to increment 
by 10 after each line; NUM nn, to begin line 
entry at Line nn with an increment of 10; 
or NUM nn.mm, which forces the next 
statement number to be nn and the incre- 
ment to be mm. Example: NUM 100,20. 

The last command format may be used 
to insert new lines between code that al- 
ready exists (e.g. NUM 11,1 to enter up to 
nine lines of code between Lines 10 and 20). 

REN— Renumber the file. It will rese- 
quence all the line numbers of the source 
file. The command format is REN, to 
renumber starting with 10 and using an 
increment of 10; REN nn, to renumber with 
an increment of nn starting with 10; or REN 
nn,mm, to renumber with an increment of 
nn starting with mm. Example: REN 100,10. 

When inserting a lot of new code, REN 
may be used to space the line numbers 
wider apart, thus allowing entry of more 
new code with the NUM entry method be- 
tween consecutive lines of source code. 

FIND— -The FIND command can be used 
to help locate any string of text anywhere 
in the program. This command format is 
FIND/string/, to find the first occurrence of 



string, and display the line it is found on; 
FIND /string/A, to find all occurrences of 
string. Each line is listed to the display as 
it is located. Pressing Control-1 will halt 
screen scrolling; FIND/string/xx to find 
string on Line number xx. The line is list- 
ed, if found; or FIND/string/xx, yy <A, to find 
all occurrences of string from Lines xx 
through yy, inclusive. Example: 
FIND/LABELl/1000,5000, A . 

Note that when searching, the line num- 
bers themselves are ignored (you don't 
search the line numbers, when looking for 
a particular number). In the examples 
above, the string of interest is delimited by 
the slash (/) character. Any matched pair 
of characters may be used as delimiters. The 
following would be used to find all occur- 
rences of the slash character in your 
program: 

FIND */*,b 

REP— Replace strings in the file. The 
command format is REP/oldstring/new- 
stringl, to replace the first occurrence of 
oldstring with newstring; REP/old- 
stringlnewstringl ,A , to replace all occur- 
rences of oldstring with newstring (use the 
"all" option with care); REP/oldstring/new- 
string/xx,yy, to replace the first occurrence 
of oldstring with newstring in the line num- 
ber range xx to yy; REP/oldstring/new- 
string/xx,yy,A , to replace all occurrences of 
oldstring with newstring in Lines xx through 
yy; or REP/oldstring/newstring/xx,yy,Q, to 
replace with query. You will be prompted 
to press "Y" for each replace. Example: 
REP/LDA #$02/LDA #$04/100,200,Q. 

LIST— The LIST command is used to dis- 
play, print or save assembly source code. 
The format is LIST, to list the entire pro- 
gram to the screen; LISTnn,mm, to display 
Lines nn through mm; LISTifP:, to send the 
entire source program to the printer; LIST 
#C:, to list the source code to cassette in 
ASCII form; LIST ffl.filename.ext to list 
the entire program to the file filename, ext 
on Disk Drive 1; LIST #D:file- 
name.ext,nn,mm to list Lines nn through 
mm to the file filename.ext. Example: 
LIST#D : M YPROG. SRC, 100, 1000. 

Any filename or device specification may 
be followed by the line number range 
specification. 

PRINT— The PRINT command functions 
exactly like LIST, except the line numbers 
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DOS (DISK OPERATING 



SYSTEM), FROM ATARI 



DOS 2.0s ALL THE WAY 



THROUGH DOS-XE AND 



EVEN THE SPARTADOS X 
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are not output. Since assembly source files 
require line numbers, it won't be very use- 
ful to PRINT your program to disk and at- 
tempt to ENTER it later. This would 
hopelessly confuse Asm/Ed. Always LIST 
source code to disk. 

ENTER— The ENTER command is used 
to retrieve a previously listed source file. 
A valid input device must be specified such 
as ENTERED MYFTLE. ASM or ENTERXC:. 

If you wish to merge a program, append 
a ",M" to the ENTER command, like EN- 
TER m -.ROUTINES. ASM, M^ This merge 
works the same as the following sequence 
would in Atari BASIC: 

LOAD "DiMYPROG.BflS" 
ENTER "DiNEWSUBS.LST" 

The lines are merged. If any line num- 
bers in the file to be merged match those 
of the file already in memory, the merge file 
takes precedence. If you wish to append a 
file to a current working program, it may 
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be best to ENTER the merge file first, 
renumber it with some large range such as 
20000,1 and then LIST it out to a temporary 
file. Then ENTER your main program, and 
finally ENTER with the merge option this 
renumbered file. 

SAVE— Use the SAVE command to write 
a block of memory, such as an object pro- 
gram, to a file. Let's say your program be- 
gins at $4000 (with an =$4000 at the top 
of your assembly code). After the ASM 
command, you see the final address was 
$41FE. Then, to create a binary image of 
this file, which may be loaded and run later, 
enter SAVE #D:MYFILE.OBJ x 4000,41FE. 

Note that the addresses are always as- 
sumed to be in hexadecimal, and you do not 
specify a dollar sign ($) to indicate this on 
the SAVE command line. You may also 
SAVE to the cassette (#C:). With the prop- 
er ASM command, your object files may 
be created automatically, as we will see. 
Note that you may assemble your program 
in memory, and then go to DOS and use the 
DOS memory save command to create this 
object file as well. (The advantage of the 
DOS memory save command is that you can 
specify the RUN address as well, so that 
your program automatically executes when 
you perform a binary load. There are ways 
to set this up with the ASM command as 
well.) 

In BASIC, filenames are enclosed by 
quotes, such as SAVE"D:MYFILE.BAS". In 
Asm/Ed, the filename is preceded by the 
pound sign (#); no quotes are used. File- 
names you may use are shown here: 

E: The screen editor, used by default with 
some commands such as LIST. 

#P: Refers to the printer. 

#C: This is used in reference to the Atari 
program recorder. 

#Dn:filename.ext This is a disk file. The 
n is the drive number, which may be from 
1 to 8, depending on the DOS and drive 
configuration you employ. If no drive num- 
ber is specified, drive 1 is assumed. The 
name of the file may be up to eight alphanu- 
meric characters, followed by a period and 
an optional three-character extender. The 
extender may be anything you wish. ASM 
or SRC is generally used for assembly 
source files, and OBJ or COM for executa- 
ble object files. 

ASM— Once you have created your as- 
sembly source code and listed it to a file 
for safe keeping, it is time to assemble it. 
This is Asm/Ed's primary function, to con- 
vert your source code into executable ob- 
ject code. When you issue the ASM 
command, the current file in memory is 
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scanned for syntax errors. If it understands 
all your source code, all the assembly 
mnemonics are converted into equivalent bi- 
nary codes and written to memory or a file. 

Care must be taken that your code assem- 
bles to an area of memory that does not con- 
flict with your source code. Before 
assembling a program for the first time al- 
ways enter the SIZE command. Three hex- 
adecimal numbers will be displayed, such 
as: 

10F4 1345 9C1F 

The first number indicates where in 
memory your source code begins, just 
above DOS's basic memory requirements. 
The second number is where, in memory, 
your source code ends. The final address 
is the top of usable RAM. At the top of your 
program will always be a statement similar 
to the following: 

la *_$400o 

This tells the assembler to start building 
your object code at memory location 4000 
hexadecimal, the program origin. This ad- 
dress may be any number between the sec- 
ond and third numbers reported by the SIZE 
command, with some notable limitations, 
when assembling to memory. It may be any 
value above the first number, so long as you 
assemble to a file. 

If you wish for your program to assem- 
ble into lower memory, you may use the 
LOMEM command. This must be the first 
command entered, once you start up 
Asm/Ed and receive the EDIT prompt. The 
format is LOMEM xxxx, where xxxx is the 
hexadecimal address to set the new low 
memory value. This is the first address val- 
ue reported by the SIZE command detailed 
above. For example, if you want your pro- 
gram to load at address $2400, and you 
know the object code will be 4K or less, 
then use LOMEM $3400 ($1000 is 4K 
bytes). Then ENTER your program, and 
use =$2400 at the top of the file to set the 
origin. Then the program may be assem- 
bled in RAM to RAM safely, so long as 
your object code does not grow beyond 4K. 

If you plan to write stand-alone assem- 
bly programs, which may be loaded from 
DOS with the binary-load command (op- 
tion "L"), I recommend an origin of $3400. 
This will set the start address of your code 
above both DOS.SYS and DUP.SYS RAM 
in Atari DOS, any version through DOS- 
XE, as well as any version of SpartaDOS. 

Unlike BASIC, you must manage mem- 
ory yourself. If your program origin is too 
close to the second number from the SIZE 



command, the assembler may get confused. 
The assembler must build a symbol table 
and assign some temporary storage as it 
processes your source code. It starts build- 
ing this information from the end of your 
source code and grows upward. If the sym- 
bol table runs into the area where the ob- 
ject code is being stored in RAM, the 
assembler is likely to generate a lot of er- 
roneous phase errors. If your origin is set 
too high, your object code will run into dis- 
play memory and eventually run out of 
room. 

These problems may be avoided in several 
ways. The general form of the ASM com- 
mand is ASM §D .SOURCE, #D:L1ST,§ 
D.OBJECT. 

The first filename in the ASM command 
represents the file your assembly source 
code is stored in. This allows you to assem- 
ble from disk (but not cassette, since 
Asm/Ed requires multiple passes through 
the file). If this field is empty, simply place 
a comma immediately after the ASM com- 
mand; then the source code is assumed to 
be in memory. The second filename speci- 
fies a listing file, where a complete "assem- 
bled listing" is routed. This will usually be 
the printer {HP:). If this field is left empty 
(you must still include the comma, though), 
the listing goes to the screen. The listing 
always goes somewhere; it cannot be turned 
off as it can in MAC/65. However, assem- 
bler directives may be used to control the 
output of a listing, as we shall see. The third 
field is the filename where the object code 
will be stored. If this field is not specified, 
your program is assembled to memory. Al- 
ways make a current listing of your program 
on disk or cassette before issuing the ASM 
command. If you have set up memory map- 
ping improperly, the source code will get 
clobbered in a big hurry. 

Assembler Directives 

Directives, or pseudo operations (pseudo- 
ops), are special instructions to the assem- 
bler. They can be used to control listing for- 
mat, program title for listing, allocation of 
memory, and more. In general, assembler 
directives begin with a period (.), followed 
by some key word and associated 
parameters. 

OPT— The options directive controls as- 
sembler output. They are .OPTNOLIST, to 
suppress the output of the listing during as- 
sembly; .OPT LIST, to output assembly list- 
ing (default); .OPTNOOBJ, to not generate 
object code during assembly; .OPT OBJ, to 
output object code (default); .OPTNOERR, 
to not display error messages while assem- 
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bling (there is no good reason to ever use 
this option); .OPT ERR, to display error 
messages when assembling (default); .OPT 
NOEJECT for no margin at the bottom of 
each page when outputting the listing; .OPT 
EJECT, to skip four lines at the end of each 
page (default). 

More than one option may be placed on 
a single line, such as .OPTNOLIST,NOOBJ. 
Note that the MAC/65 assembler defaults 
to .OPT NOOBJ; it does not generate ob- 
ject code unless explicitly told to with the 
.OPT OBJ directive. Asm/Ed is just the op- 
posite. Whenever you are assembling your 
program frequently, working out syntax and 
undefined label errors, it is generally wise 
to have a .OPT NOOBJ near the top of your 
program. When you are ready to generate 
code and start test running it, then change 
it back to .OPT OBJ. 

TITLE and PAGE— The title and page 
directives are designed to make your assem- 
bly listings easier to read. The title direc- 
tive is generally used to specify the name 
of your program, revision and date. The 
page directive can be used to force a page 
break and optionally output some text. For 
example: 



10 

28 



.TITLE "attack Of The Dweebies" 
.PAGE "PrograM equates" 



200 .PAGE "Graphics Routines" 



300 .PAGE "High Score Routine" 

TAB— The TAB directive is used to set the 
spacing of the fields of your assembly code 
for listings. The command format is .TAB 
12,17,27. This example illustrates the 
defaults used by Asm/Ed. These may be set 
to any position you find most suitable for 
your printer listings. The first number in- 
dicates the field where the mnemonics (as- 
sembly op codes) will appear, the second 
for the operands, and the third for the com- 
ment field. For example, suppose your pro- 
gram has a lot of long labels with a 
maximum of 15 characters. Then you may 
wish to set the tabs as .TAB 20, 25, 40, 
which would make for a prettier listing on 
the printer. 

BYTE, DBYTE and WORD-The BYTE, 
DBYTE, and WORD directives are used to 
reserve storage in memory, similar to vari- 
ables in BASIC. Labels may be associated 
with these directives for easy reference. For 
example: w§ L[>fl 5T()RflGE 

110 LDK STORAGE+1 



5O0 STORAGE .BYTE 34,545 

In the above the statement, Line 100 will 
fetch the first value at location STORAGE, 
which is the number 34 following the BYTE 
directive. In Line 110 the X register will re- 
ceive the data value 45 hexadecimal. Note 
that the assembler will perform the address 
arithmetic SFORAGE+1 automatically. The 
BYTE directive may also be used to reserve 
storage for strings: 



100 LDA tJSTRING/SlOO 
110 LDX USTRINGSSFF 



320 STRING .BYTE "This is a test", 155 

In Line 320 the BYTE directive reserves 
storage for a string initialized to "This is 
a test" followed by a 155 (ATASCII carriage 
return). The code in Lines 100 and 110 
fetches the address of the label STRING, 
placing its address high byte in A and the 
low byte in X. This technique is common- 
ly used to pass the address of data collec- 
tions (such as strings or data tables) to 
subroutines. 

The DBYTE directive reserves two con- 
secutive memory locations, generally used 
for numbers greater than 256, in high-byte 
low-byte order. For example: 

1O0O DATA .DBYTE 258 

The above will result in two bytes of 
memory being reserved at location DATA, 
with the values 1 and 2 respectively (1256 
+ 2 equals 258). Addresses are stored in 
low-byte high-byte format as expected by 
the 6502 microprocessor. The WORD 
directive is used for this, such as: 

100 *=$340O 

110 START LDA 845 



290 RTS j End of prograM 

300 *=$2E0 

310 .HORD START 

In Line 100 the origin of the program, or 
program counter, is set to 3400 hex- 
adecimal. The first line of code, with the 
label START, will then be assembled into 
your computer's memory at $3400. At Line 
300 the program counter is reset to $2E0. 
At Line 310 we have the WORD directive, 
immediately followed by the label START. 
The assembler will 'backtrack' as it 
processes your source code, realize that 
START refers to memory location $3400, 
and place this value (low-byte high-byte or- 
der) in memory at $2E0, $2E1 respective- 
ly. This is a special location, commonly 
referred to by name as RUNAD in Atari 
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memory maps. When you assemble a pro- 
gram to disk which will be loaded and run 
from DOS, you use the above technique to 
set the run address of your program. When 
the program ends with an RTS, control is 
returned to DOS. Most game programs do 
not end, but you will use this technique for 
many utilities. As we will see later, a BRK 
instruction is used, instead of RTS, when 
testing programs from Asm/Ed's debugger. 
Label Directive— You do not have string, 
integer and floating point variables in as- 
sembly language, the way you do with Atari 
BASIC. As we saw above, you must set up 
your own storage and interpret it properly. 
There are no automatic mechanisms in as- 
sembly language for managing variables. To 
make life easier, you will want to attach 
meaningful labels to constant values, such 
as: 



10 RUNAD 



$2E0 



1000 *=RUNAD 
1010 .HORD START 

It is much easier to tell from this exam- 
ple that the intended run address of our pro- 
gram is defined at the label START. In the 
previous example for the WORD directive, 
we simply had the number $2E0. Unless 
you want to memorize a lot of memory lo- 
cations, employ meaningful labels wherever 
practical. 

Labels are used for reference when you 
want to GOTO (JMP) or GOSUB (JSR) in 
assembly language. For example: 

IB PROMPT .BYTE "PRESS RETURN 
TO CONTINUE", 155 



100 LDA ttPROMPT/SlOO 
110 LDX ttPROMPT«$FF 
120 JSR PRINTSTRING 



500 PRINTSTRING STA ICBADR+1 
510 STX ICBADR 

Labels may also be used in branch in- 
structions such as: 

50 CONTINUE LDA TABLE, X 



100 DEX 

110 BEQ EXITLOOP 

120 BNE CONTINUE 

130 EXITLOOP STA RESULT 

In the above example, we have set up a 
loop, similar to a BASIC FOR/NEXT loop, 
between the labels CONTINUE and EX- 
ITLOOP. In Line 100 the X register is 
decremented by 1 (we assume it was initial- 
ized by some code previous to Line 50). If 
the result of the DEX instruction is zero 
(BEQ) then control will be passed to EX- 
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ITLOOP. If the X register has not gone to 
zero (BNE) the control is sent back up to 
CONTINUE. As a result of DEX, the zero 
flag can only be set (BEQ) or cleared 
(BNE), so we have exhausted the possibil- 
ities. It would have been equally valid to 
use: 

120 JMP CONTINUE 

Generally, whenever you have the choice 
between a JMP and Bxx (branch) instruc- 
tion, use the branch. It will require less 
memory and work faster. The problem is 
that a branch is limited to plus or minus 127 
bytes from the current position. If you try 
to branch too far, you will get an assembly 
error. Then JMP instructions, or combina- 
tions of JMP and branch instructions may 
be required. 

Origin Directive— -We have already used 
the origin directive "[ ]=" in many of the 
previous examples. This tells the assembler 
"set the program counter to the following 
address." The address may be some num- 
ber, or a label, or some expression (so long 
as the assembler may resolve it to a fixed 
value). Some examples are: 

100 *=$3400 

300 START = $4400 

310 *=START 
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50O *=START + 439 



600 HERE *=*+45 



Take note of the spacing used in all of our 
examples. Any label always begins one 
space after the line number, referred to as 
the label field. The op code field begins at 
least one space after the start of the label 
field. If a line of code has no label on it, 
then your assembly mnemonics may begin 
two spaces after the line number. At least 
one space after the op code field will be- 
gin the operand field. This field is option- 
al since not all assembly mnemonics have 
an op code (such as DEX or INY). Any- 
thing after the operand field is ignored by 
the assembler and assumed to be the com- 
ment field. A comment can take up an en- 
tire line, when the label field begins with 
a semicolon. 

/F— The IF directive is used for "condi- 
tional assembly." This may be used to ena- 
ble or disable the generation of some test 
code, for example, based on the value of a 
number, label or expression. For example: 

10 DEBUG = ;Enable test code 



300 .IF DEBUG GENDOFDEBUG 
310 ; Debugging test routines 



500 ENDOFDEBUG 

If the expression (DEBUG above) is 
equal to zero, then everything from the line 
following the IF directive to the specified 
label (ENDOFDEBUG) is assembled. 
When you are satisfied that your code 
works, don't throw away all that useful test- 
ing code. Simply change Line 10 to 
DEBUG=1 and reassemble your program. 
If you do not understand the use of condi- 
tional assembly, don't worry. I have only 
used it a few times in the past seven years, 
and generally you don't need it at all. 

END— The Asm/Ed manual recommends 
that every program have one .END direc- 
tive, as the last line. It really isn't neces- 
sary, since the assembler knows when to 
stop (it runs out of source code to assem- 
ble). If you place an .END in the middle 
of your program inadvertently, all code af- 
ter it will be ignored and not assembled. 
I seldom use a .END in any of my assem- 
bly code. 

More to Come 

Next month, we'll finish up our quick 
reference to the Atari Asm/Ed cartridge by 
discussing error codes, expressions and the 
debugger, among other things, r 
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3 Not all of my design suggestions were 
carried out. For example, the "TWO 
COLUMN SIDEBAR" head shown here 
didn't make it into the finished book be- 
cause I forgot to write up the specs. The 
scan of Al Lewis was done with PictaScan 
at screen resolution, the only resolution 
available with this otherwise excellent scan- 
ner. For this project, such a scan would have 
been acceptable since it was "For Position 
Only." (All illustrations of the Munsters in 
these samples are copyright 1989 by MCA 
Publishing Rights, a Division of MCA Inc. 
Used with permission.) 
4Here, I've just set the text wraparound for 
the polygon I created around the Munster 



family, l made it large so I could click on 
either the picture or the shape to help posi- 
tion them. The next step is to call down the 
Object menu and choose zero for the Line 
choice, leaving the polygon invisible except 
for the graphic itself. Open polygons can 
be very useful for creating unusually shaped 
text. 

5 Here's a snapshot of my tags for the Mun- 
sters book sample pages. Note the 
"Muntextl" entry: To get the first paragraph 
of every chapter to run without an indent, 
I made a duplicate of the "Muntext" tag, 
without the paragraph indent. Get your tags 
set up before working, and life with Page- 
Stream is much easier, m 
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Donavan Vicha has been writing about 
desktop publishing on the Atari ST for three 
years. He uses a Mega ST2 system for his 
freelance editorial service, adapting 12 
years of book-publishing experience to this 
rapidly growing field. He lives in Chicago 
with his wife and two sons. 
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: s that time of year again. Atari 8-bit and 
ST users everywhere are starting to think 
about what program or peripheral will make 
the perfect gift, either for themselves or for 
someone else. There are literally thousands 
of currently available products that will 
make any Atari system complete. These 
products will help you get the most out of 
your Atari computer. 

The following, then, is ANALOG'S annu- 
al gift guide. Here you will find the best and 
most useful products for your computer. 
Some products are mentioned specifically 
by name, while other product categories are 
discussed generally. A list of the manufac- 
turers and their addresses can be found at 
the end of the article. 

Space does not permit me to mention 
every Atari-related product ever made. Nor 
can I even mention all of the good Atari 
products I use or know about. My apologies 
in advance if I leave out your favorite. How- 
ever, I do know what the needs of the typi- 
cal user are, since I too am a user. Further, 
having written about Atari computers for 
the past five years, I am well-informed 
about existing products. 

Products are listed in order of occurrence: 
that is, the order in which they occurred to 
me. First, generic products and services 
that are useful to both 8-bit and ST users 
* are described. Next, 8-bit software is men- 
tioned, followed by ST software. I guaran- 
[ tee that you can use any of these products 
]j and still respect yourself in the morning. 
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GENERIC GIFTS FOR ALL 
ATARI USERS 

There are many generic gifts useful to an 
Atari computer user. One of the best you 
could give or receive is a membership to 
an Atari Users' Group. There are many fine 
groups around the country, and most clubs 
offer both 8-bit and ST special-interest 
groups. They also have knowledgeable peo- 
ple who are willing to help the other guy 
out. 

Atari Users' Groups have monthly meet- 
ings, publish newsletters and often have 
libraries of public-domain software. Meet- 
ings typically include question-and-answer 
sessions, hardware and software demonstra- 
tions and even guest speakers from Atari 
and various software companies. Many also 
have electronic bulletin boards for their 
members' use. 

Membership to an Atari Users' Group 
typically costs about $20 and provides one 
of the best sources of information about us- 
ing your ST and 8-bit computer. To locate 
the nearest Atari Users' Group contact Atari 
Corporation directly. Whether you are just 
starting out with your new Atari computer 
or are a seasoned veteran, joining a local 
user group is worthwhile. The Washington 
Area Atari Computer Enthusiasts publish- 
es one of the best user-group publications 
in the country. Their newsletter is called 
Current Notes and looks more like a maga- 
zine in size and content. Each issue features 
product reviews, special reports and tutori- 
als. It has a glossy cover, is well-written and 
looks professional. A ten-issue subscription 
costs $24 and can be obtained by sending 
a check payable to: Editor, Current Notes, 
122 N. Johnson Road, Sterling, VA 22170. 
Current Notes is an example of a high- 
quality user-group publication. 

Curtis Manufacturing has a number of 
products for users of any computer. Two 
products that I use are the Curtis Clip and 
the Computer Tool Kit. The Curtis Clip is 
a simple but useful plastic paper holder that 
attaches to either side of your monitor. The 
$6 product will hold a single sheet of pa- 
per at eye level for easy typing or reference. 
In addition, the clip swings out of the way 
when not in use. 

The Curtis Tool Kit lists for $30 and con- 
tains just about all the tools you need for 
normal work on your computer. The kit in- 
cludes flat-blade and Phillips screwdrivers, 
two sizes of nut drivers, a chip extractor, 
chip inserter, parts grabber and tweezers. 
All tools are demagnetized and housed in 
a zippered pouch. Although you may not 
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need every tool, it's good to have them avail- 
able and in one place. 

Your Atari computer system represents a 
sizable investment in hardware. Unless you 
protect it with a surge protector, your equip- 
ment is susceptible to the power fluctuations 
of your local power company. Temporary 
power surges, spikes, too-high or too-low 
voltage can seriously damage your hard- 
ware. A number of devices are sold to of- 
fer protection from these kinds of 
catastrophes, but their quality ranges from 
poor to excellent. 

Panamax offers a complete line of high- 
quality products that work as advertised. 
Their products include multiple-outlet 
strips, power-line conditioners, telephone- 
line protectors and under-voltage protectors. 
Various features are offered on the differ- 
ent models, such as circuit breakers, alarms 
and on/off switches. Panamax's models 
range from $50 to $150. 

One of the best ways to participate in the 
world of Atari computing is by using the 
DELPHI telecommunications service. 
DELPHI is an online information service 
which, among others things, hosts two Atari 
Forums: one for 8-bit users and one for ST 
users. Both forums are operated by the edi- 
tors and staff of ANALOG. 

A host of services and features is avail- 
able on the DELPHI Atari Forums. Elec- 
tronic mail can be sent and received by 
Atari 8-bit and ST users worldwide. Thou- 
sands of free programs can be downloaded 
from the database areas, including the pro- 
grams presented each month in ANALOG. 
The conference feature allows you to meet 
electronically with other Atari users, and 
there are regular formal online conferences 
where you can discuss important Atari- 
related topics. Access charges average as 
low as ten cents per minute from most parts 
of the country, and there is no extra charge 
for high-speed access. 

Other popular information services in- 
clude CompuServe and GEnie. To use 
DELPHI, CompuServe, GEnie or any of 
the other information services, you will 
need a modem and a terminal program. An 
excellent choice for a modem is the Supra 
2400. This is a fully Hayes-compatible 
2400-baud modem that features auto-dial 
and auto-answer capabilities. Configura- 
tions are set via commands from the key- 
board instead of by using DIP switches. The 
Supra 2400 has a list price of $140. You'll 
need an RS-232 interface, such as the Atari 
850 or P:R: Connection if you have an 8-bit 
computer. 
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For the 8-bit Ataris, the terminal program 
included with HomePak is an excellent 
choice. Good public-domain terminal pro- 
grams include Express! and Amodem 7.2. 
If you have an ST, I recommend Interlink 
by Intersect Software. This program offers 
an enhanced type-ahead buffer that allows 
you to create and edit text on the screen be- 
fore it is sent. In addition, you can capture 
your entire online session (Autolog), with 
the capture being saved to disk automat- 
ically. 

8-BIT SOFTWARE 

It seems there are thousands of products 
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made for the Atari 8-bit computers. Al- 
though the supply of new products has 
dwindled in recent years, there are many 
quality programs still available. Regardless 
of whether you have a 400/800, XL, XE or 
XE Game System, these programs allow 
you to use your computer for education, en- 
tertainment and productivity purposes. Here 
are a few suggestions for your con- 
sideration. 

APPLICATION PROGRAMS 

Word processing remains the foremost 
category of software for any computer, and 
there are several excellent choices for the 
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Atari 8-bit computers. One of the best of 
the bunch is PaperClip, originally published 
by Batteries Included. Although Batteries 
Included is no longer in business, Electron- 
ic Arts has bought the rights to their 
products. 

PaperClip runs on all Atari 8-bit com- 
puters with at least 48K of memory. Since 
it was written entirely in machine language, 
it is fast. Two different files can be displayed 
on the screen at the same time, and blocks 
of text can be moved between the windows. 
In addition, each editing window can be set 
to a different size. Further, a full page 
(greater than 40 columns) can be previewed 
on the screen. 

PaperClip has many useful features that 
assist the user. The program has one-key 
macros that can be used to add a word or 
phrase with the touch of a single key, an 
auto-save feature that automatically saves 
the text file you are currently working on 
after a predefined number of keystrokes, 
and the ability to use DOS commands 
(directory listings, LOCK, UNLOCK, 
ERASE and RENAME) from within the 
word processor. Other features include ex- 
tensive HELP, word-count display, UNDO 
command, global replace on chained files 
and printer-configuration files for most 
popular printers that are used with Atari 
computers. (You can also create your own 
configuration file.) 

Electronic Arts distributes another origi- 
nal Batteries Included product that may be 
one of the best 8-bit software values around. 
Called HomePak, it is three programs in 
one: a word processor, terminal program 
and database. HomeText is an excellent 
entry-level word processor, but does not 
have the dozens of features contained in 
PaperClip. HomeTerm is one of the best ter- 
minal programs for the 8-bit computers. 
HomeFind is an electronic filing system. 
Other word processors to be considered 
include, Atariwriter Plus, The Writer's Tool 
and Letter Perfect. Atariwriter Plus is a 
descendant of the original, excellent 
Atariwriter word processor and maintains 
command similarity with its predecessor. 
It's a full-featured word processor that offers 
block functions, spelling correction (via a 
separate program), predefined and cus- 
tomizable printer drivers, text-formatting 
and word counter. In addition, a scrollable 
window is used to show text that is wider 
than 40 columns. 

The Writer's Tool was originally pub- 
lished by OSS but is now being distributed 
by ICD. It is a high-end word processor that 
has more features than any other similar 



8-bit program. Although it takes a little time 
to master, it is especially useful for some- 
one who does a lot of writing. 

Letter Perfect has been around a long 
tirne. Although LJK is no longer in busi- 
ness, the program can still be found at many 
dealers and represents a quality product 
with plenty of features. Any of these word 
processors will give you all the capability 
you could want in an 8-bit program. 

GRAPHICS 

The Print Shop from Broderbund Soft- 
ware is a classic 8-bit program that lets you 
create letterheads, posters, banners and 
greeting cards. Once you finish your design 
(either from canned samples or cus- 
tomized), the output can be printed on a va- 
riety of dot-matrix printers. The program 
contains all of the elements (graphic sym- 
bols, fonts and forms) you need to produce 
any design and is easy to use. All you have 
to do is step through the various menus and 
choose whatever options you like. The 
package also includes a supply of colored 
paper and envelopes. 

Broderbund also sells several companion 
products for the Print Shop called the 
Graphics Library. There are three volumes 
available, each containing additional clip 
art, fonts and designs. 

Another excellent graphics program is 
The Newsroom by Springboard. It lets you 
create signs, brochures, newsletters and oth- 
er simple publications like a desktop- 



can be purchased separately. The Newsroom 
is not a desktop-publishing program per se, 
but can be used like one. It features auto- 
matic text flow around graphics, a logical 
menu-based interface and support for over 
50 printers. 

If you have used more than one of the 
8-bit graphics programs, you have no doubt 
realized that many of them have their own 
file format. Files created by one program 
cannot generally be used by another. Now 
there is a way to convert graphics files from 
one format into another. The program is 
called Graphics Transformer by Alpha Sys- 
tems. The $25 program can read Koala Pad, 
Atari Light Pen and Touch Tablet, Print 
Shop, Paint, Graphics Master, Movie Mak- 
er, Bl Graph, Super Sketch, MicroPainter, 
Microlllustrator, text modes 0, 1 and 2, 
Computer Eyes and many more graphics 
format files. It can then convert these files 
into one of the following graphics files: 
Typesetter, MicroPainter, Microlllustrator, 
Print Shop, Koala, Atari Touch Tablet and 
MagniPrint 11+ . 

There is another handy product from Al- 
pha Systems called MagniPrint 11+ . This 
print-utility program lets you print all 
graphics modes files (including GTIA 
modes with 16 shades), enlarge or shrink 
pictures, print in normal or inverse and 
print selective areas of a picture. In addi- 
tion, the program will print horizontally or 
vertically, read a variety of graphics files 
and allow you to change graphics modes for 
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publishing system. As such, you must cre- 
ate and assemble each of your pages with 
text, clip art and graphics. Over 600 graph- 
ics are included with the package, and more 



special effects. 

An additional supplied program will print 
BASIC program listings complete with 
graphics and inverse characters. Magniprint 
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11+ supports Epson, Panasonic, C. Itoh, 
NEC, Gemini and Star printers and sells for 
$20. 

GAMES 

My list of recommended 8-bit games 
would probably fill this' entire magazine. 
However, there are a number of outstand- 
ing titles of which any would make an Atari 
user happy. Many games are no longer sold 
by the original publisher either because they 
have gone out of business or have sold the 
rights to someone else. In addition, a num- 
ber of games have been repackaged as 
"budget" titles on disk or as cartridges. 
One of the most enduring and endearing 
8-bit games is Flight Simulator II by sub- 
LOGIC. This excellent flight-simulation 
program is one of the most complete exam- 
ples of the genre I have seen for any com- 
puter. The game consists of a single-engine 
plane simulation where you can -either fly 
prescribed courses or practice the many 
aspects of flight. Excellent documentation 
accompanies the program and additional 
course disks can be purchased. Highly 
recommended. 

My favorite text-adventure game is still 
Planetfall from Infocom. This game com- 
bines adventure, science fiction and humor 
into an engrossing example of what is called 
interactive fiction. For a child or someone 
new to the text-game genre, I would recom- 
mend Seastalker, also from Infocom. It is 
not as difficult or complex as Planetfall, but 
offers a good challenge and, like all Info- 
com games, has excellent documentation. 
Every Atari owner should own at least one 
Infocom text-adventure game. Prices range 
from $30 to $50. 

Electronic Arts has lowered the price on 
many of their 8-bit games and now markets 
them under the "Classics" category. They 
now typically sell for under $15. One of the 
most creative and innovative games they 
ever produced was Pinball Construction 
Set. Written by Bill Budge, this game lets 
you create your own pinball games from a 
video parts box. You can then edit and save 
those games for future play. 

Another classic from EA is Seven Cities 
of Gold. It is an excellent example of what 
an 8-bit game can be. You play the role of 
a 16th-century Spanish explorer, searching 
for new worlds, peoples and glory. Your 
own personality and belief system determine 
how you play the game, and the hidden fea- 
ture of the game is self-awareness. 

Atari has bought the rights to a couple of 
dozen 8-bit games and repackaged them in 
cartridges. These XE Game cartridges are 
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marketed toward the XE Game System, but 
they will work in any 8-bit Atari computer. 
Some of the better titles include Archon 
(Electronic Arts), Necromancer (Synapse), 
Mario Brothers (Atari), Chop lifter (Broder- 
bund), Ball Blazer (Lucasfilm Games) and 
Rescue on Fractalus (Lucasfilm Games). 
The XE Game carts sell for $25 to $35. 

MISCELLANEOUS GOODIES 

The P:R: Connection from ICD 
represents one of the best ways to satisfy 
your 8-bit interfacing needs. It allows you 
to connect a Centronics parallel printer and 
two RS-232 devices to your 8-bit computer. 
Both the parallel and serial ports are virtu- 
ally identical to that of the standard Atari 
850 interface. Since the P:R: Connection 
takes its minimal power needs from your 
computer, no separate power supply is 
necessary. The P:R: Connection sells for 
$70 and includes a free terminal program 
with the package. However, one of its main 
advantages is that it allows you to use 
industry-standard products, such as RS232 
modems and Centronics printers, which can 
be used with other computers as well. 

There are a number of 8-bit disk operat- 
ing systems currently available. One of the 
most powerful is SpartaDOS X from ICD. 
SpartaDOS X comes in a special 64K car- 
tridge and gives the Atari computer a full 
complement of DOS commands. The car- 
tridge consumes none of the computer's 
memory and also has the provision to ac- 
cept another cartridge. 

t TOUCH -UP 
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Features of SpartaDOS X include the 
ability to create subdirectories, directly 
change the status any of a number of file 
attributes, display the contents of the file 
and set the time and date of the R-Time 8 
cartridge (if you have it) or the system 
clock. It also provides other file commands, 
such as COPY, FIND, ERASE, RENAME 
and DIR. Other features include a batch file 
and archive utility, the ability to switch to 
internal BASIC on an XL or XE computer 
and I/O redirection. SpartaDOS X sells for 
$80. 

How would you like to have a graphics 
interface for your Atari 8-bit computer? It 
is possible with Diamond GOS from Reeve 
Software. Diamond GOS (Graphics Oper- 
ating System) is a "piggy-back" cartridge 
and disk software that provides a GEM-like 
Desktop on your 8-bit screen. The GOS al- 
lows you to have multiple windows open at 
once, where you can run programs and per- 
form maintenance activities, such as copy- 
ing and erasing files, formatting disks, 
viewing the contents of disks, etc. Also in- 
cluded with Diamond GOS is Diamond 
Paint and utility disk. The entire package 
sells for $80 and requires an ST mouse. 
Educational computing is another cate- 
gory in which the Atari 8-bit excels. Al- 
though it has been available for several 
years, the AtariLab science kit allows you 
to perform experiments with the computer. 
The Atari lab Starter Set consists of a hard- 
ware interface device that plugs into a 
joystick port, a 16K ROM cartridge contain- 
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ing the temperature program, a temperature 
sensor, a standard thermometer and a 
140-page manual. Users can make obser- 
vations, take temperature measurements and 
then analyze the information. 

The AtariLab Light Module kit is a com- 
panion product that requires the starter kit. 
It contains a cartridge, manual, light sen- 
sor, polarizer, filters, light stick and other 
items. The Light Module contains experi- 
ments to observe the light level of a can- 
dle, measuring response time of the light 
sensor, measuring how light passes through 
various materials and how polarizers work. 

The documentation included with both 
modules stresses the scientific method and 
the importance of such things as calibration, 
repeated observation and proper data analy- 
sis techniques, such as graphing. The manu- 
als also contain detailed information about 
the hardware interface itself and how it may 
be used with your own BASIC or Logo pro- 
grams to measure real-world information or 
control outside devices, such as relays and 
switches. The Atarilab Starter Set with Tem- 
perature Module sells for about $50. The 
Light Module costs about $40. 

ST SOFTWARE 
APPLICATIONS 

The most frequently used application 
program on any computer is word process- 
ing, and there are several excellent word- 
processing programs for the ST, the most 
sophisticated of which is WordPerfect from 
WordPerfect Corp. This $250 program pro- 
vides all of the normal functions one would 
expect, such as BLOCK/MOVE, 
SEARCH/REPLACE, headers/footers, 
column printing (two kinds), spelling 
checks, a thesaurus and much more. In ad- 
dition to the normal functions, such ad- 
vanced features as automatic backups, 
paragraph numbering, outlining, automat- 
ic hyphenation, multiple undo levels, mul- 
tiple on-screen windows (up to four), 
footnoting/endnoting, indexing and table of 
contents generation are included. WordPer- 
fect competes easily with major word- 
processing programs available for MS-DOS 
computers. Although the list price seems 
high, WordPerfect ST can typically be 
bought at a large discount. 

If your word-processing needs are a lit- 
tle more modest, a couple of other pro- 
grams are more than adequate. WordWriter 
from 1'imeworks is a GEM-based program 
that offers multiple windows, headers, foot- 
ers and on-screen display of text styles. 
Word Writer also offers a thesaurus and 



spelling checker. The spelling checker pro- 
vides multiple personal dictionaries and can 
check an entire document or individual 
words as you type. 

WordWriter sells for $80 and is easy to 
learn, thanks to the drop-down menus with 
equivalent key commands. In addition to be- 
ing a stand-alone word processor, Word- 
Writer interfaces with other Timeworks 
products, such as their database program 
(Data Manager) and spreadsheet (Swift- 
calc). Text files from 75/ Word can be im- 
ported, and printer drivers are provided for 
a variety of printers. 

Another excellent ST word processor is 
Word Up from Neocept. Word Up uses 
GDOS to produce high-quality output con- 
taining multiple fonts and different type 
sizes. Up to four windows can be open at 
once, each containing a different file. Oth- 
er features include extensive block func- 
tions, headers, footers, endnotes, automatic 
file backup and the ability to incorporate 
graphics (DEGAS, Neochrome and .IMG 
files). 

Although Word Up doesn't contain all of 
the features of WordPeifect, it will print the 
highest resolution your printer is capable 
of. Further, it is an easy program to use. 
At $80, Word Up should definitely be con- 
sidered when you are looking for a word 
processor to call your own. 

A number of desktop-publishing pro- 
grams are available for the ST. By combin- 
ing the three elements of word processing, 
page layout and drawing into one program, 
you can easily design, compose and paste 
up the contents of a printed page for forms, 
newsletters, charts, etc. You normally see 
exactly what you will get on the screen be- 
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fore it is printed. These programs range 
from simple-to-use entry-level products to 
more complicated programs intended for 
professional users. 

One of the most popular desktop- 
publishing programs is Desktop Publisher 
STby Timeworks. An easy-to-use program, 
it includes fully integrated word processing, 
page layout, typesetting and graphics func- 
tions all in one package. Some of the ma- 
jor features of the program include a full 
GEM interface with pull-down menus; 
icons; scroll bars and dialog boxes; flexi- 
ble page layout to let you overlap, reposi- 
tion and resize your text; columns and 
graphics; built-in fonts that range from sev- 
en to 72 points; and high-quality output to 
a dot-matrix or laser printer. 

Text can be imported from 1st Word Plus, 
Word Writer ST or any ASCII file so the pro- 
gram can work with existing word proces- 
sors. Graphic files can be imported from 
DEGAS, Neochrome and Easy Draw file 
formats. Further, you can view, edit and lay- 
out pages in actual, double or half-size win- 
dows. Desktop Publisher ST sells for $130. 

A professional-level desktop-publishing 
program is Calamus from ISD Marketing. 
The program provides text and document 
processing, design tools and page-layout 
capabilities that rival and often surpass 
those found in MS-DOS desktop-publishing 
programs. It uses a full GEM interface with 
mouse control and drop-down menus, or it 
can be used with keyboard commands. Vec- 
tor fonts rather than Postscript-type fonts are 
used, and the program provides many fea- 
tures, such as outline fonts, printer preview, 
automatic kerning and stretching. 

Other features of Calamus include auto- 
matic text flow from one page to another; 
automatic kerning in all fonts and sizes; 
word, character and line spacing adjust- 
ments; page and chapter numbering; text 
import and export; built-in macros and 
much more. Calamus can also create out- 
put in PDL, DDL, interpress and linotype 
formats. It sells for $300. 

PageStream from SoftLogik is another 
high-level desktop-publishing program. It 
incorporates typographical features, word 
processing, page layout and graphics. It also 
offers such capabilities as color-separation 
of pictures within documents and color 
printing. Word-processing features include 
spell checking, search and replace by attrib- 
utes, automatic kerning, scalable fonts and 
text flow around irregularly shaped graph- 
ics. Text rotation can be performed in one- 
degree increments and text point sizes range 



from l/50th to 1,310 points. PageStream 
sells for $200. 

If you have any programs that use Atari's 
GDOS (graphics device output system), 
such as CAD or desktop-publishing pro- 
grams, you know how slow the output can 
be. Further, you also know that GDOS is 
a memory hog, is temperamental (it must 
be unloaded when a non-GDOS program 
is run) and is unwilling to let you change 
fonts and drivers after it has loaded. Thank- 
fully, CodeHead Software has created 
G+Plus as a replacement to the original 
GDOS. 

G+Plus is an entirely distinct product 
that remedies the problems users have had 
with GDOS. Although it acts like GDOS 
(in terms of function), it offers better com- 
patibility with non-GDOS programs, in- 
creases the speed of output and increases 
the speed of program execution (with those 
that need GDOS functions). In addition, it 
allows you to switch ASSIGN. SYS files 
from the desktop without having to reboot 
the computer. G+Plus sells for $35. 

GRAPHICS 

DEGAS Elite is one of the best values in 
ST graphics software and has become a 
standard. The program allows you to paint 
in any of the three ST graphics modes and 
save your files to disk. DEGAS Elite con- 
tains a multitude of features, including: the 
use of eight work screens; the ability to cut 
and paste all or parts of these screens to 
each other or to disk; the ability to create 
and use clip art; block operations, such as 
stretch, rotate, horizontal or vertical skew- 
ing and distortion. Of course, the neat fea- 
tures involve color animation. Complete 
control of the direction, speed, colors and 
other aspects of the animation is at the 
user's command. DEGAS Elite retails for 
$50 and is distributed by Electronic Arts. 

If you use any of the ST graphics pro- 
grams, such as DEGAS or Neochrome, you 
may be interested in an animation program 
that makes your artwork come to life. 
Called Make It Move, this $50 program 
from Michtron is really more of an easy- 
to-use slide-sequencing and -manipulation 
program than an animation program. 
Nonetheless, Make It Move is great for such 
tasks as creating video titles, making 
presentations and polishing your collection 
of ST graphic images. The program is 
mouse-driven, easy to use and doesn't re- 
quire any special programming skills. Fea- 
tures include screen wipes in any of four 
directions, fades and quick cuts, each with 



user-specified durations. Further, objects 
may be zoomed, panned, hidden and 
moved. 

Another graphics program that allows you 
to be creative is PrintMaster Plus from Uni- 
son World. With it, you can easily create 
calendars, fliers, stationery, banners, invi- 
tations, signs and greeting cards with many 
types of printers. The $40 program is menu- 
based, allows you to preview your design 
before you print it and permits you to save 
your graphic to disk. In addition, Print- 
Master Plus will work with add-on font and 
graphic disks. 

Still another excellent graphics program 
is Art and Film Director by Epyx. This $80 
package includes Art Director, a full- 
featured paint program that uses all the 
power of the Atari ST to create dazzling 
works of art. Menus and icons appear on- 
screen that allow you to choose among a va- 
riety of shapes, lines and colors from the 
palette, as well as perform such actions as 
stretch, bend, bulge, spin and rescale to en- 
hance the pictures. 

Film Director then uses true eel anima- 
tion to transform artwork into stunning 
graphic presentations. It's easy to automate 
many of the repetitious steps required by 
traditional types of animation. The program 
also includes a library of music and sound 
effects to create just the right ambiance. 

Printers are capable of printing in reso- 
lutions of 100 dpi (9-pin printers) to 300 dpi 
(laser printers). However, graphics pro- 
grams, such as Neochrome and DEGAS 
Elite, can only create graphics as good as 
the screen image (a 640x400 monochrome 
screen resolution translates to about 80 dpi 
when printed). With Touch Up from Mi- 
graph, you can edit and print these graph- 
ics images with as high a resolution as the 
printer can handle. 

One of the main features of Touch Up is 
the ability to convert 16-color low- 
resolution pictures into image files (color 
mapping). Six different ways to do this are 
provided and each produces better results 
at the expense of requiring more time to ac- 
complish. For example, this procedure al- 
lows you to first convert a low-resolution 
graphics image created in DEGAS Elite into 
an image file and then import that image 
file into a desktop-publishing program. 
Graphics file conversion is also available to 
and from DEGAS, DEGAS Elite, Ne- 
ochrome, MacPaint, TIF, .PCX, .IMG and 
.GEM formats. 

The $180 Touch Up program also contains 
full-featured drawing capabilities for bit- 
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mapped images. A variety of drawing tools, 
such as geometric shapes, lasso, fill pat- 
terns, line sizes, ten fonts (with attributes), 
etc. , is provided to create and edit images. 
Advanced functions, such as Spines and 
Bezier curves, are also included. All in all, 
Touch Up is a sophisticated yet easy-to-use 
graphics utility program. 

UTILITY PROGRAMS 

Utility programs are the glue that holds 
various ST application programs together. 
They also provide a means to make your 
computer more productive. Whether you 
need to convert files from one format into 
another, perform routine maintenance on 
your system or just want to be able to use 
all of the capabilities of your ST, utility pro- 
grams are a necessary component of your 
software library. 

MultiDesk allows you to use any desktop 
accessory program on your ST at any time 
without rebooting the computer. In addi- 
tion, you are not limited to the six desktop 
accessories (.ACC files) loaded at once 
when the computer boots up. MULTI- 
DESK. ACC is loaded as one of the six pos- 
sible accessories when the ST boots up in 
the usual manner. However, from within 
MultiDesk, you can access up to 32 addi- 
tional accessories. 

MultiDesk works as either a desktop ac- 
cessory or as a regular GEM program. 
When run as a program, it gives you ac- 
cess to any desktop accessory whether it has 
already been loaded or not. MultiDesk sells 
for $32 and is an excellent utility. 

If you have a hard disk, the $60 Michtron 
Hard Drive Turbo Kit will be an essential 



utility program. The Turbo Kit contains 
three hard-disk products (upgraded versions 
of previously released separate programs) 
in one: backup, optimize and disk cache. 
Each of the programs has a variety of fea- 
tures and options to simplify and enhance 
its use. The backup utility allows you to per- 
form either a file-by-file or image (sector- 
by-sector) backup of the hard disk. You can 
produce a full backup of the entire hard disk 
or an incremental backup of only those files 
that are new or that have changed since a 
specific date. A restore program allows you 
to copy the files from the floppies back onto 
the hard disk in the event of a hard-disk fail- 
ure. Tuneup is the optimize program, which 
improves the file-access time of the hard 
disk by unfragmenting (rewriting all of the 
data to contiguous sectors) files. Perfor- 
mance is also increased by moving all of the 
hard disk's free space to one contiguous sec- 
tion. The hard disk can be optimized either 
for read access or read/write access. The 
third part of the Hard Drive Turbo Kit is 
M-Cache: a disk-cache utility. A disk cache 
is another way to improve the performance 
of a hard disk by holding recently accessed 
disk sectors in memory, much like a RAM 
disk. 

NeoDesk is an alternative desktop for the 
ST that both replaces and extends its func- 
tions. Although it looks similar to the nor- 
mal ST Desktop, there are a number of 
significant and subtle differences that vast- 
ly improve the use of the desktop. Some of 
the features of NeoDesk include arranging 
file icons to fit the size of the window, dis- 
playing the total size of a selected group of 
files, being able to format disks in differ- 
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ent formats, displaying program files as 
icons on the desktop in addition to files 
within a window and not changing the 
date/time stamp when copying a file. 

NeoDesk allows you to exit the program 
and return to the normal Desktop at any 
time, regaining all of the memory that the 
program used. In addition, the NeoDesk 
desktop can be saved to disk, complete with 
program icons, as well as auto-executed 
when you boot the ST. NeoDesk costs $30 
and is an example of what the ST Desktop 
should be. 

Tempus is a GEM-based text editor that 
was originally published by Eidersoft. As 
a text editor rather than a true word proces- 
sor, it includes medium- and high- 
resolution support, mouse or keyboard 
operation, auto indentation for structured 
programming, online help menus and au- 
tomatic line-number generation. The most 
outstanding feature of this product is its 
speed, which is blindingly fast. Compared 
to a word processor, Tempus is four to ten 
times faster in loading files, scrolling the 
document from top to bottom and search- 
ing and replacing on a single character. 
Compared to another text editor, such as 
MicroEMAX, Tempus is from one-and-a- 
half to five times faster for the same oper- 
ations. 

Now MichTron has bought the rights to 
the program and has released Tempus II. 
The new version increases the speed of the 
original and adds new commands and key- 
board shortcuts. Features of Tempus II in- 
clude the ability to edit up to four files 
simultaneously, optional word wrap with 
justification, search-and-replace options 
with wild cards, an assortment of block 
commands, 20 user-definable function-key 
macros, a sort utility, automatic file save, 
and cross-reference generation. Tempus II 
sells for $80. 

Still one of the best ST accessory 
products is DeskCart! from Quantum 
Microsystems Inc. (QMI). Deskcart! con- 
tains a battery-backed-up real-time clock 
and a plethora of desktop accessories on one 
cartridge. Only 75K of precious RAM is 
consumed by the accessory programs. 

The 14 accessories include a calendar 
good to the year 2040; an appointment book 
with alarm; a notebook, which is really a 
mini-word processor that allows you to cre- 
ate, edit and save multiple 12 -page notebook 
files; a card file that allows nine lines of 
data; a good calculator; a typewriter that al- 
lows you to use the ST to address envelopes 
or print other short, quick pieces; an ad- 
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dress book; a VT-52 terminal emulator; 
keyboard macros; a RAM disk of any size 
on any drive; disk utility functions; a print 
spooler; a control panel similar in function 
to the ST's control panel; and a screen dump 
and memory test. DeskCart! retails for $100. 

GAMES 

Ah, games. The ST is unquestionably a 
premier game-playing computer, and the 
number of excellent games now available at- 
test to this fact. I might as well first describe 
one of my favorite games of all time: Tetris. 

Tetris is a puzzle game with a simple con- 
cept. You rotate and position into a solid 
row at the bottom of the screen various- 
shaped blocks that fall from the top. Points 
are awarded as each solid row is formed 
then disappears. As gaps are left within a 
row, the rows build up line by line until they 
reach the top of the screen. When there is 
no more room for blocks to fall, the game 
is over. You can either let the pieces fall at 
their own speed or drop them yourself for 
more points. Tetris is a Soviet-designed 
game and offers nine levels of addictive 
play. At each higher level, the pieces fall 
at an increasingly faster rate and there is a 
different background screen. Also, you can 
begin the game with varying numbers of 
pieces already on the screen for an even 
greater challenge. Other features include 
turning the sound effects on or off, display- 
ing statistics on your progress and preview- 
ing the next piece that will fall. Tetris sells 
for $40. If you are going to buy one ST 
game this year, Tetris should be it. 

Another excellent ST game is Arkanoid 
from Taito Software. Similar in many ways 
to Breakout, Arkanoid consists of several 
rows of "bricks" of different designs, a ball 
and a sliding paddle. However, unlike 
Breakout, when certain bricks are hit, they 
release capsules with special powers. The 
capsules must be captured with your pad- 



dle to gain their special properties. Capsules 
release additional balls, allow your paddle 
to capture the ball, award extra lives, dou- 
ble the size of your paddle, temporarily slow 
the ball down, advance you to the next 
screen and give you a laser weapon to shoot 
the bricks. Arkanoid has 33 screens, each 
more difficult than the last, and sells for 
$40. 

Another of my favorite games is Typhoon 
Thompson from Broderbund Software. 
Written by Dan Gorlin of Choplifter fame, 
Typhoon Thompson offers excellent anima- 
tion, 3-D graphics and challenging game 
play. In the game, you control a Jet-Sled (a 
water craft) around the unchartered ocean 
planet Aguar. Your mission is to rescue a 
missing sea-child from the Sea Sprites, 
which live in these tropical waters. To do 
so, you must overcome the many defenses 
of the Sea Sprites. Further, you must cap- 
ture all of the Sea Sprites from all seven is- 
lands within a village in order to retrieve 
one of the four artifacts from the Spirit 
Guardians. Each succeeding mission is 
more difficult until you are destroyed or 
save the sea-child. Your final score is based 
upon the number of tasks you complete, the 
number of islands won, the number of 
Sprites captured and the amount of time it 
took to complete them. 

What makes Typhoon Thompson so good 
is the quality of the graphics and the atten- 
tion to detail. The Jet-Sled has a very fluid 
motion to it, and control of it feels natural. 
You can see the expressions of the captured 
Sprites, and the game has an overall dreamy 
look. Typhoon Thompson sells for $35. 

Tower Toppler from Epyx is an interest- 
ing variation of the Q-bert-style "hopping 
game." The goal of the game is basically 
to avoid the monsters and get to the top. But 
like many games with a simple concept, 
completing the game is more difficult than 
it looks. In Tower Toppler, eight giant tow- 



ers rise from the depths of a toxic ocean. 
The goal is to destroy each tower after you 
have reached the top. Each tower has ob- 
stacles, such as deadly rolling boulders, dis- 
integrating ledges, indestructible mutant 
molecules, flying phantoms and flashing 
blockades. You can hop over some of the 
obstacles or ride emergency elevator lifts, 
and a snowball gun can be used to freeze 
or destroy the enemies. As you climb the 
towers, they rotate with you so your van- 
tage point changes. 

If you fail to reach the top of a tower in 
the given time limit, the game ends. Extra 
points can be earned by catching fish be- 
tween the completion of each of the tow- 
ers. Tower Toppler sells for $40 and allows 
one or two players to play. In addition, there 
are two missions to choose from. 

Lords of Conquest by Electronic Arts 
sells for $20 and can be compared to the 
board game Risk. It's a classic strategy 
game in which the action takes place on a 
world map. Up to four players can play at 
once and each opponent chooses home ter- 
ritory, then tries to protect his holdings 
while conquering territories belonging to 
other players. Games can take anywhere 
from a half hour to several hours to play. 

Another good game from Electronic Arts 
is Zany Golf. More like an arcade game than 
a golf simulation, Zany Golf 'is like a minia- 
ture golf course from hell. Like traditional 
miniature golf, there are nine holes, each 
presenting a particular obstacle to over- 
come. However, the obstacles themselves 
make the game so challenging (and interest- 
ing): Flying carpets, bouncing hamburgers, 
pinball machines and "rubber birdie bogey 
bumpers" are not found on your typical golf 
course. 

Each hole has a par value and allows a 
certain number of strokes. Once you make 
the putt, any remaining strokes are carried 
over to the next hole. When all of your re- 
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maining strokes are depleted, the game is 
over. Of course, each hole is increasingly 
more difficult and the final hole, "Dr. 
Frankenstein's Private Country Club," is ex- 
ceedingly challenging. Zany Golf sells for 
$40 and offers top-notch graphics and 
music. 

ODDS AND ENDS 

Practical Solutions offers several products 
that, as their company name implies, solve 
minor problems encountered with using an 
ST and peripherals. If you happen to have 
both a monochrome and a color monitor for 
your ST, attaching and re-attaching the mo- 
nitors can be a pain. Monitor Master allows 
you to simultaneously connect mono- 
chrome, RGB and composite monitors to 
your ST (composite video available only on 
STs with internal composite video). Then, 
by simply pressing a button you can switch 
from one to the other. In addition, a sepa- 
rate RCA audio-out jack is provided on the 
switch box. Monitor Master is a passive de- 
vice and sells for $55. 

Another useful product from Practical 
Solutions is Mouse Master. If you have a 
1040ST, you know that it is difficult to at- 
tach a mouse or joystick since the ports are 
located underneath the computer. Mouse 
Master plugs into the joystick ports beneath 
the computer and allows you to easily hook 
up the mouse or joysticks. In addition, both 
a mouse and joystick can be permanently 
attached and switched from one to anoth- 
er. Mouse Master requires no separate pow- 
er supply and sells for $4Q. 

Neither the 1040ST nor the Mega com- 
puter contains an internal RF modulator. 
Therefore, these machines do not provide 
composite video output. If you want to rec- 
ord your graphics designs on a VCR or play 
games on a big-screen TV, you're out of 
luck. Unless you have VideoKey. 

VideoKey is a small box from Practical 
Solutions that converts the RGB signals 
from the ST into color-composite video that 
is superior to even that available on the STs 
that do have an RF output. VideoKey is 
designed primarily for low-resolution col- 
or, used by the majority of games and ani- 
mation. A separate external power supply 
operates the unit, but since it is invisible 
to your system, you need not unplug your 
existing monochrome or color monitor. 
VideoKey sells for $100. Another product 
from Practical Solutions is the Tweety 
Board. The ST computer actually has three 
separate audio channels, which are accessed 
by the Tweety Board. It provides true ste- 
reo output from the audio generated by the 
ST. Instead of the tinny sounding audio you 



normally hear through your monitor speak- 
er, the full audio capability of the ST can 
be heard through your stereo or sound sys- 
tem. The Tweety Board is compatible with 
all ST software and installs inside the ST 
without any soldering. It sells for $60. 

If you have been searching for the ulti- 
mate joystick, your quest might be over. I 
know of two joysticks that offer state-of-the- 
art performance at a reasonable price. Wi- 
co's Ergostick is one. It is a short "throw" 
stick with a steel shaft that has a slightly 
sticky soft covering that is easy to grip. 
Quality microswitches are used for durabil- 
ity and to provide better feedback to the 
user. The Ergostick sells for $25. 

Another excellent stick is the Epyx 
500XJ. This too is a small stick, but the 
base conforms to the shape of your hand and 
is less fatiguing. There is a groove for the 
thumb on the base, and the trigger button 
is strategically located under the tip of the 
index finger. This stick is made to be held 
with the left hand while the right hand's 
fingers perform the action. The Epyx 500XJ 
has a sturdy design and feels solid to the 
grip. It sells for $25. 

FOR THE ST USER WHO 
HAS EVERYTHING 

Several years ago, David Small designed 
the Magic Sac cartridge that gave Macin- 
tosh compatibility to the Atari ST computer. 
In his latest effort, and from his own new 
company, Gadgets By Small, he has 
designed a new, improved product called the 
Spectre 128. It is a Macintosh Plus emula- 
tor cartridge and software that has a faster 
screen redraw and file-access time com- 
pared to the Magic Sac. 

The Spectre 128 can use either Mac 128K 
or 64K ROMs (that you must buy else- 
where). Although it does not read Mac 
disks directly (a forthcoming product called 
GCR will do that), the $180 product runs 
dozens of Mac software products (such as 
HyperCard, Adobe Illustrator and 
PageMaker) at up to 20 percent faster, and 
it can use the larger ST monochrome 
monitor. 

Digital Vision was the first to develop and 
market a video digitizer for the 8-bit Ataris. 
Their video digitizer for the ST is called 
Computereyes. It includes both hardware 
and software, and it supports all of the 
graphic capabilities of the ST. The hardware 
interfaces easily to any source of standard 
NTSC color or black-and-white composite 
video. These sources include video 
cameras, VCRs, video laser discs and oth- 
er computers. All capture and display func- 
tions are mouse-controlled under GEM, 



and images may be captured in either mon- 
ochrome or full color. 

Automatic calibration of brightness, con- 
trast and color balance is performed by the 
Computereyes software. Once the image has 
been captured, the brightness, color con- 
tent and contrast can be easily adjusted to 
suit your needs. Further, the images saved 
by Computereyes are compatible with Ne- 
ochrome, DEGAS, DEGAS Elite and other 
graphics programs. Computereyes ST re- 
tails for $250. 

One of the major upgrades for the ST is 
a hard disk. There are a number of vendors, 
drive sizes and options to choose from. All 
hard-disk drives mentioned here are relia- 
ble, differing only in their price, physical 
dimensions and length of connecting cable. 

Atari offers two hard drives that differ 
only in price and the size of the case. The 
SH204 is a shoe box-size model that has a 
19-inch cable and 20 megabytes of storage. 
It sells for $700. The Atari MegaFile 20 
sells for $900 and can serve as a monitor 
stand or fit under a Mega ST. Both drives 
come with boot, format and autoboot pro- 
grams. In addition, a disk-cache program 
is also provided. 

Supra drives range in size from 20 mega- 
bytes to 60 megabytes. They are about the 
size of a shoe box and feature a 19-inch ca- 
ble that connects to the DMA port on the 
ST. In addition, all Supra drives come with 
a boot program, a utility for mapping bad 
sectors and a formatting program. The 
drives are available from either the factory 
or retailers. The Supra 20-, 30-, 45- and 
60-megabyte drives sell for $700, $795, 
$995 and $1,295, respectively. 

ICD also makes hard disks for the ST. 
Designed to fit under your monitor, the ICD 
FA20ST provides 20 megabytes of storage 
and features a 31-inch cable. Innovative fea- 
tures, like a built-in clock with battery back- 
up, adjustable legs for positioning the mon- 
itor and providing cable clearance, and the 
ability to daisy-chain additional DMA 
devices are also included. Software consists 
of boot, format, autoboot and utility pro- 
grams. The FA20ST retails for $700. Oth- 
er ICD hard drives are available: 
30-megabyte, $950; 50-megabyte, $1,100. 

THAT'S ALL, FOLKS! 

That concludes this year's gift guide. I 
hope you'll manage to find that perfect gift 
for your favorite ST owner. Of course, this 
article makes a great "want" list too. Just 
circle items you'd like to find under the 
Christmas tree and leave the magazine open 
in a strategic place. You might just get 
lucky. e\ 
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Alpha Systems 
4435 Maplepark Rd. 
Stow, OH 44224 
(216) 374-7469 

Atari Corp. 
1196 Borregas Ave. 
Sunnyvale, CA 94088 
(408) 745-2000 

Broderbund Software 
17 Paul Drive 

San Rafael, CA 94903-2101 
(800) 527-6263 

CodeHead Software 

P.O. Box 4336 

North Hollywood, CA 91607 

(213) 386-5735 

Curtis Manufacturing Company, Inc. 
30 Fitzgerald Drive 
Jaffrey, NH 03452 
(603) 532-4123 

CompuServe Communications 
5000 Arlington Center Blvd. 
Columbus, OH 43220 
(614) 457-0802 

DELPHI 

General Videotex Corp. 

3 Blackstone Street 

Cambridge, MA 02139 

(800) 544-4005 

(617) 491-3393 (in MA) 

Digital Vision 

14 Oak St., Suite 2 

Needham, MA 02192 

Electronic Arts 
1820 Gateway Drive 
San Mateo, CA 94404 
(800) 245-4525 

Epyx, Inc. 

600 Galveston Drive 
Redwood City, CA 94063 
(415) 366-0606 

Gadgets By Small 

40 W. Littleton Blvd. #210-211 

Littleton, CO 80120 

(303) 791-6098 

Gribnif Software 
P.O. Box 350 
Hadley, MA 01035 
(413) 584-7887 



ICD, Inc. 
1220 Rock Street 
Rockford, IL 61101-1437 
(815) 968-2228 

Intersect Software 
2828 Clark Road, Suite 10 
Sarasota, FL 34231 
(813) 923-8774 

ISD Marketing, Inc. 
2651 John Street, Unit #3 
Markham, Ontario 
Canada L3R 2W5 
(416) 479-1880 

Microprose 
120 Lakefront Drive 
Hunt Valley, MD 21030 
(301) 667-1151 

MichTron 
576 S. Telegraph 
Pontiac, MI 48053 
(313) 334-5700 

Migraph, Inc. 
200 S. 333 St., #220 
Federal Way, WA 98003 
(206) 838-4677 

Mindscape 
3444 Dundee Rd. 
Northbrook, IL 60062 
(312) 480-7667 

Neocept 

547 Constitution Ave. , Unit A 
Camarillo, CA 93010 
(805) 482-4446 

Panamax 

150 Mitchell Blvd. 
San Rafael, CA 94903 
(800) 472-5555 

Practical Solutions, Inc. 
1930 E. Grant Rd. 
Tuscon, AZ 85719 
(602) 884-9612 

Quantum Microsystems, Inc. 
P.O. Box 179 
Liverpool, NY 13088 
(315) 451-7747 

Reeve Software 
29W 150 Old Farm Lane 
Warrenville, IL 60555 
(312) 393-2317 



Softlogik Corp. 
11131F South Towne Square 
St. Louis, MO 63123 
(314) 894-8608 

Spectrum Holobyte 
2061 Challenger Drive 
Alameda, CA 94501 
(415) 522-3584 

Springboard Software 
7808 Creedridge Circle 
Minneapolis, MN 55435 
(612) 944-3915 

subLOGIC 
713 Edgebrook Drive 
Champaign, IL 61820 
(217) 359-8482 



Supra Corporation 
1133 Commercial Way 
Albany, OR 97321 
(503) 967-9075 

Taito Software, Inc. 

11715 North Creek Parkway South, Suite 110 

Bothell, WA 98011 

(604) 984-3040 

Timeworks 
444 Lake Cook Rd. 
Deerfield, IL 60015 
(312) 948-9200 

Unison World 

2150 Shattuck Ave., Suite 902 

Berkeley, CA 94704 

(415) 848-6666 

Wico Corporation 
6400 West Gross Point Rd. 
Niles, IL 60648 
(312) 647-7500 

WordPerfect Corp. 
288 West Center St. 
Orem, UT 84057 
(801) 225-5000 

Xlent Software 
P.O. Box 5228 
Springfield, VA 22150 
(703) 644-8881 
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_Jeyond the important aspects of such ani- 
mation basics as squash-and-stretch, antic- 
ipation, characterization through motion 
and so on (discussed last time), there is an- 
other realm of techniques that fall under 
the general heading of "special animation 
effects." These range from such simple 
things as speed lines to the bizarre world 
of distortion, double and triple images and 
so forth. If you want to animate something 
moving quickly, exploding, being disin- 
tegrated, flattened, you'll want to take ad- 
vantage of these techniques. 

LESS IS MORE 

Before we proceed, I feel it's important 
to once again stress that the following tech- 
niques should not be overused. They should 
be used only where necessary. The reasons 
for this sparing usage are twofold: First, 
they are meant to add energy and/or life to 
a scene or action, and their overuse tends 
to make them less special, and, consequent- 
ly, they have less impact. Second, since 
most of these techniques involve some kind 
of distortion of the image to attain a cer- 
tain effect, continual use gives the viewer 
a chance to see the effect repeatedly, allow- 
ing them to see through the effect to what 
you're actually doing. Therefore, they start 



PHng the effect as an zM ^rather than as 
part of the action. 

I've said it before^ffll I'll say it one mj 
time: Nothing ex«fflis like exce. 




Try making some relatively large object 
move across the screen in a span of ten 
frames or less. Go ahead, try it. No matter 
what animation program you're using, 
chances are you're going to notice a sort of 
"jumping" effect. The object doesn't seem 
to actually move smoothly across the 
screen. It gets there in a series of small 
"hops". No matter how fast the playback is, 
you can see each individual image. And, be- 
cause these images are so few and the 
changes in each frame so great, it seems 
there's almost nothing you can do about it. 
Adding more frames would smooth out the 
action, but it would also slow it down. Even 
at full-speed playback, the object wouldn't 
seem to be moving all that fast. So, how can 
you make an object move quickly from one 
position to another without encountering 
this staccato movement problem or slow- 
down? There are a number of techniques 
that can be used to cover this effect, but the 
three basic types are speed lines, blurs and 
distortions. 



PEED LINES 

■Ploiows these. They appeur 
irywhere from animated cartoons to com- 
ic books. When you want to imply speed, 
you simply do not fully draw the trailing 
edge of the fast-moving object/character, but 
instead draw a lot of parallel lines in its 
wake. In animated film this effect is usual- 
ly accomplished via a technique known as 
"dry brushing," wherein a brush with very 
little paint (nearly dry) is used to streak the 
colors of an object, creating speed lines. 
How to do this with your ST varies with the 
software you're using. Since you have to 
deal with pixels and limited resolution, the 
easiest speed lines to draw are those that are 
perfectly horizontal or vertical. In such 
cases you might manually draw the lines on 
a specific frame or frames, or, if the pro- 
gram you're using allows it, cut out a copy 
of the object, then paste it down elsewhere 
and edit it. You would then knock out every 
other line with the transparent background 
color, cut out this new brush and then paint 
a trail behind the object. To make this ef- 
fect less mechanical, you would make the 
lines of uneven length and perhaps even let 
some of the blur spill over parts of the ob- 
ject. Figure 1 demonstrates these steps. 
Please note that to use this technique, you 
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may have to save a "safety" copy of the 
original frame, so that if the speed lines 
obliterate important details, you can retrieve 
them from this backup screen. Also, if an 
object has many details and colors, you may 
have to touch up the speed lines. The rule 
of thumb is that each speed line should be 
the same color as the pixel from which it 
originates on the object. If a speed line 
comes off a brown belt, it should be brown. 
The exception to this is speed lines over a 
color where the actual color wouldn't work, 
such as a brown sleeve moving in front of 
the jacket it's attached to. In such a case, 
you will probably have to use a different 
color or the lines won't show up. 

Speed lines have some limitations. They 
don't work well if the background features 
a lot of cluttered colors or lines that paral- 
lel the speed lines. In such instances the 
speed lines can get lost. Furthermore, while 
speed lines can be successfully maintained 
for a considerable period of time in a tradi- 
tional animated cartoon, they don't tend to 
work well on computers if used for more 
than a handful of frames. This is because 
the drybrush technique used on eels pro- 
vides a certain amount of randomness to 
each frame, so that each line doesn't stand 
out for long. On a computer, the screen 
resolution tends to make the lines heavier, 
and such randomness is much harder to 
achieve. Therefore, the lines themselves are 



much more obvious and have a tendency to 
"stand still," drawing attention to them- 
selves. 

BLURS 

Blurs are often accomplished in the same 
manner as speed lines, but they are usually 
heavier. For instance, having a character 
turn his head suddenly might involve one 
frame where the head is almost to its desti- 
nation pose, but all the colors "leak" back 
toward the previous position. The key 
difference between a blur and a speed line 
is that a blur isn't a bunch of parallel lines, 
but a mass of color, occasionally featuring 
a few speed lines atop it for added effect. 

Blurs don't always convey as much veloc- 
ity as speed lines. Speed lines lend a look 
of great speed to a movement because they 
are somewhat transparent, making it seem 
as if the object passed by so fast that you 
could see through it. Because blurs tend to 
be more opaque, they seem to have more 
weight and thus less speed. They are bet- 
ter for shorter actions, like the aforemen- 
tioned head movement, rather than 
something like Road Runner bolting down 
the highway at Mach 2 (which is better ac- 
complished with speed lines). 

DISTORTIONS 

To the average viewer of animated film, 
this is probably the least-noticed speed ef- 
fect. It is the "stretch" part of squash-and- 
stretch taken to ridiculous extremes. Rath- 
er than some mild warping of form to lend 
a little more oomph to an action, a distor- 
tion is a wild deformation of an object for 
a frame or two (no more). It is commonly 
used to accomplish nearly instantaneous 
transitions from point/position A to B. 

For instance, in Bob Clampett's The 
Great Piggy Bank Robbery (1946), Detec- 
tive Duck Twacy (Daffy Duck) is on the 
phone, and in the span of three frames he 
goes from leaning on one side of a desk to 
laying atop it, on his back, on the other side. 



ve said it 
before, and I'll say 
it one more time: 
Nothing exceeds 
like excess. 



There is a frame where he starts moving, 
one where he stops, and the single frame 
in between them features a drawing of Daffy 
that is hardly recognizable as the duck. The 
animator has created a pose that features 
one half of Daffy in the starting position and 
the other half in the destination position, 
with the duck's details stretched in between, 
as if he were made of Silly Putty! The draw- 
ing is so severely distorted that when you 
look at it your mind refuses to believe such 
a wild drawing would work at all. You 
think, "Surely, that bizarre image would 
stick out like a sore thumb." But, no, when 
you view the cartoon, you don't see it. You 
see Daffy zip into another pose, but you 
don't actually see the distorted drawing. 
Chances are, even if you've watched it via 
freeze-frame, you'll have a tough time see- 
ing it during normal playback. 

A few months back, I loaded one of the 
scenes from the Art & Film Director video 
into my ST and decided to try a little ex- 
periment on it. At the end of the shot, 
Megabit Mouse spun around and hurled a 
mallet at and through the Art Director tool- 
box. I had never been satisfied with this ac- 
tion, because I was unable to make him 
throw it as fast as I wanted and have it look 
right. To get a pleasing action, I had to use 
more frames than I wanted, and the throw 
lacked the force I sought. As an experiment, 
I deleted a few frames of Megabit spinning 
around with the hammer and replaced them 
with a single frame featuring a wildly dis- 
torted mouse. Figure 2 shows the start and 
end positions, with the distorted image in 
the middle. Like the Daffy Duck scene 
described above, when I played it back I 
couldn't really see the distorted image, but 
wow! did that throw have force! That sin- 
gle frame of distortion accomplished what 
I thought was impossible. 

Such wild distortion can be used to 
strengthen a lot of other types of action. Just 
freeze-frame through almost any door-slam 
in an old theatrical cartoon. The door 
"bends," its top and bottom trailing. In the 
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middle of its action, it will often appear six 
times as thick as normal. The doorknob 
may even lag behind, stretched out, and ac- 
tually sink into the door when it catches up. 
Cars bunch up and change shape as they 
"wind up" to zip away, buildings bulge and 
radically change shape and volume, and 
characters' limbs become massive arcs for 
a single frame. 

And it's all virtually invisible to the 
viewer. 

MULTIPLE AND 
AFTERIMAGES 

Another technique for enhancing move- 
ments is the use of multiple images. These 
can sometimes be used in lieu of speed lines 
and blurs and are often useful for effects in- 
volving movements too rapid to animate 
/ith single images on each frame. 
Afterimages have a distinct look. Specif- 
ically, they tend to be either transparent or, 
at the very least, dimmer than the object 
in its current position. If not, it becomes 
difficult to discern which image is the ac- 
tual object. The easiest way to create an af- 
terimage for a frame is to take the previous 
two or so frames, combine them into a new 
image, dim the colors (if your palette per- 
mits) and add them to the current frame. 
The best program for such effects has to be 
Cyber Paint, where you can overlay and un- 
derlay pictures and whole animation se- 
quences. If you do this to each frame, the 
selected moving objects will have "trails" 
that follow them. If done properly, they can 
add the illusion of speed, but more often 
they are used for different effects. 

(Using TRACE ON in Film Director au- 
tomatically leaves afterimages, but it leaves 
all afterimages for the range of frames 
selected, and no color-dimming is 
possible.) 

While afterimages are composed of mul- 
tiple items, what I refer to as multiple 
images is a different animal. This means 
creating a frame that has two or more im- 
ages of the same item or character. For in- 
stance, a frame that has a character looking 
both left and right at the same time (in es- 
sence, having two heads). Multiple images 
are mostly used for extremely rapid motions 
where more poses must be struck than there 
are available frames. For instance, you want 
a character to look up, down, left and right 
numerous times in a matter of only a few 
frames. You do this by having one frame 
where the character is looking one way, an- 
other frame where he is looking in three 
directions at once (perhaps enhanced with 
speed lines), another with him looking in 



two directions and so on. The eye doesn't 
necessarily perceive these as the same im- 
age. You see him looking wildly about, 
striking more poses per second than there 
are frames. 

This same technique is used for vibra- 
tions. Let's say your character has just been 
hit on the head, which vibrates like mad. 
Drawing his head in a series of positions 
going left to right would look just like his 
head going from left to right. To get the 
chaotic feel of a real vibration, multiple 
images are used. Like the example of the 
guy looking in multiple directions at once, 
here we draw the character's head in the 
same way on each frame, but on some 
frames we have two, others three, another 
one and so on (you may add some speed 
lines to heighten the effect). If you make 
sure not to put any specific or repeating pat- 
tern into it, the effect will be one of his head 
rapidly vibrating. If you make the images 
fall into a repeating cycle, such as one head, 
three, two, one, two, and then repeating the 
cycle again, the viewer will pick up on this, 
and the illusion will be destroyed. 

VIOLENT SOLUTIONS 

In classic cartoons, the most common 
"effects" were violent actions, such as ex- 
plosions, crashes and other catastrophes. 
Most of us are consciously aware of such 
obvious effects as fiery explosions, clouds 
of smoke and cartoon characters imprinted 
in steel doors. Those are pretty obvious. But 
there's a whole range of techniques used to 
make these acts of violence have more 
impact. 

For instance, let's say you want to drop 
a safe on a bulldog. How do you do it? You 
animate the safe falling into the picture, 
covering up the bulldog as it lands on him 
and embeds itself into the sidewalk. If you 
animated such an action exactly as I've just 
described it, the action would lack any 
sense of weight and impact. How would you 
make the safe "feel" heavy? 

The easiest way is to jar the whole scene, 
as if the impact of the safe had shaken the 
camera. This can range from a slight 
quivering of the entire frame to severely 
shifting the image. Sometimes enlarging 
and shrinking the image on a few frames 
will achieve the same effect. If this is done 
over a series of frames, and it doesn't fall 
into a pattern, the shot will have a lot more 
impact than it would without this special 
effect. 

To make the impact even more severe, 
you could try tilting the entire frame; that 
is, rotating the image so it is at an angle. 



On alternating frames you would reverse the 
direction so that on one frame the image 
would tilt to the left and on the next frame 
go to the right. Doing this over a series of 
frames, varying the tilt angles all the time, 
will create the sense of a tremendous 
impact. 

Of course, since computer images rarely 
extend beyond the confines of the screen 
display, shifting and tilting images in such 
a fashion may leave blanks in your picture, 
which will have to be touched up. 

POW! 

How about a smaller impact, where you 
don't want the screen to shake? How do you 
emphasize the impact? The easiest way is 
to use an impact indicator. You know, one 
of those jagged shapes that radiates from the 
point of impact in a comic book. Of course, 
since this is animation, it has to move. One 
picture is worth a thousand words, so I'll 
let Figure 3 explain it. 

KABOOM! 

Explosions are such a common element 
in many older cartoons that I could almost 
write an article on that subject alone. For 
the sake of brevity, I'll keep it to a small 
section. 

Explosions are usually bright, quick af- 
fairs. Like the violent impacts discussed 
above, they will often involve camera- 
shaking techniques. The easiest explosions 
to animate are of the ultra-cartoony variety, 
with lots of jagged, starlike polygons of 
bright color filling the screen. These aren't 
often effective, so most explosions are of 
the fire-and-smoke variety, featuring either 
a flash followed by swirling smoke or just 
fiery-colored smoke. 

Fiery explosions are difficult to animate 
properly, particularly when you have a pal- 
ette as limited as the ST's. Usually, such ex- 
plosions feature a lot of swirling clouds of 
reds and blacks, which need to move like 
real smoke in order to look right. They also 
have to be dissolved out, which isn't easy 
to do with only 16 colors. Unless you're 
feeling really ambitious, I'd recommend not 
using such explosions. 

The most violent-looking of all explo- 
sions is the flash variety. First,a point of 
bright light briefly emanates from the ex- 
ploding object, then the entire screen goes 
white. The problem with this effect is that 
the white alone seems violent for a split- 
second. If you hold it for longer than that, 
it becomes a white screen instead of an ex- 
plosion. 

I learned the trick to this years ago when 
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I animated the Balance of Terror Star Trek 
game proposal. I wanted the starships to ex- 
plode in a way not usually seen in a com- 
puter game. No little sparks flying or 
animated fireballs. I wanted it to look like 
their power sources had been violated and 
the vessels were instantly vaporized. I 
selected the white-flash technique for this 
and solved the inherent problem by chang- 
ing the screen colors to black on every third 
or fourth frame. The effect was instantly 
transformed from a static field of white to 
a flashing, strobing spectacle. People tended 
to comment that the explosion was almost 
too violent. But it works. It's one of the sim- 
plest effects, and at the same time, one of 
the most effective. 

LIGHTNING AND 
ELECTRICITY 

Let's face it, the stereotyped zigzag light- 
ning bolt won't cut it anywhere but in the 
most cartoony of circumstances. Lightning 
doesn't look anything like the cartoon sym- 
bol of it. It's much more complicated and, 
therefore, a lot tougher to animate. 

I recently suffered through the movie Star 
Trek V, and of the myriad bad special ef- 
fects that film contained, one of the worst 



violators were the lightning bolts fired by 
the "un-God" at the film's climax. These 
things looked like beams with little electri- 
cal frayings around the edges. No go. They 
didn't work. The way to do electricity is to 
think of a Jacob's Ladder. You know, one 
of those gizmos in the labs of mad scien- 
tists where a little electrical arc runs up be- 
tween two metal rods. The electrical arcs 
seen in those writhe and twist as they go. 
You never see frayings. The electricity fol- 
lows the path of least resistance, which is 
rarely a straight line. 

The best-looking lightning-bolt effects are 
simply a bunch of thin, scrawly lines con- 
necting two points. Make those lines change 
frame after frame, and you'll get a much 
more interesting effect. If you want to 
freeze-frame through some well-executed 
lightning effects as reference, study either 
the opening scenes of Star Trek— The Mo- 
tion Picture (where the Klingon ships get 
zapped) or Return of the Jedi (where the 
emperor lets Luke have it). 

By the way, such electrical effects can 
benefit greatly from occasional one-frame 
flashes where you brighten up the palette. 
Heck, even the white/black alternating ef- 
fect discussed for explosions comes in 



handy. Make an occasional one-frame nega- 
tive image, and it works quite well. 

THE SECOND-TO-THE-LAST 
ROUNDUP 

I was planning to wrap up this series with 
this article, but it seems I've once again run 
out of space. Next time it's on to post- 
production, where we'll discuss putting it 
all together, from adding sound to putting 
it on videotape. See you then, ei 




Blissfully ignorant of the realities of time 
and space and plain old common sense, 
Maurice Molyneaux hopes someone will 
someday discover retroactive reincarnation 
so that when he dies he can come back in 
a previous life as animation director Chuck 
Jones. His greatest fear would be to come 
back as Wile E. Coyote and, in the proc- 
ess, have to learn some humility. 



How much is YOUR 
time worth? 




Turbo ST turns your 520/1040 ST into a speed 
demon. Check out Turbo ST at your local dealer 
or download our free demo from your favorite 
bulletin board. 

Upgrades to version 1.6 are only $5 with your 
original disk. For more information, call (407) 
657-4611, or write to SofTrek, P.O. Box 5257, 
Winter Park, FL 32793. 



ATHENA II 



Easy to use Computer Aided 
i Design system for the Atari ST 
Computer system. 




Don't let the other 
companies fool you! 
You do not have to 
take a college course 
or wade through a 
three inch manual in 

order to use a CAD package! Within minutes you 

can be up and running with Athena II. 

See what Athena II can do for you at your local 

Atari Dealer! ! 

0n,y $99.95 



iliad 

Software Inc. 



1470 South State, Orem, Utah 84058 (801) 226-3270 



CIRCLE #113 ON READER SERVICE CARD. 



CIRCLE #114 ON READER SERVICE CARD. 
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England, the land where the ST rules. Popping over to the underground, we take a quick 
Tube ride from Victoria Station, transfer to the Picadilly line and take it all the way out 
to Alexandria Palace, where an Atari ST show happens to be in progress. There, we are 
treated to a crumbly toasted-cheese sandwich and a few words about The Hound of Shad- 
ow from Electronic Arts U.K. 

Hound is a role-playing adventure game that adds to the Cthulhu mythos created by the 
master of the macabre, H.P. Lovecraft. Set in the Roaring '20s, it will use sepia graphics 
to keep the mood, and requires you to create a character using such attributes as sex, na- 
tionality, profession and skills. A new operating system called Timeline enables you to move 
your character to subsequent adventures while retaining the skills and lessons learned. Time- 
line also affects the game in response to the character and attributes you've chosen. Eng- 
land may seem genteel and tame, but, in Hound, evil lurks just below the surface (although, 
I doubt anything can compare with the horror of the cheese sandwich I just consumed). 

Jeff Minter is nearby. He's one of the first game programmers in England, having creat- 
ed games for the (gasp!) VIC 20, then moving over to the Atari 8-bit and now the ST. His 
Super Grid Runner maintains the excellence of fun graphics, nifty sound effects and 
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payability. Grid's premise is simple: You 
move your spaceship around a geometric 
grid pattern, avoiding the falling bombs and 
aliens. Not too complex, eh? Of course, 
there are the kamikaze spaceships, the 
replicating snakes which leave pods that 
turn into bombs, and the invulnerable mov- 
ing turrets that send blasts along the grid. 
Control of the ship is easily handled by 
mouse movements, coupled with a unique 
firing mechanism. A special nose-cone can 
be called over to the ship by pressing the 



right mouse button. Once there, a tap of the 
left mouse button fires blasts into the cone, 
which cause them to exit as multiple rays 
of greater strength and in planned directions 
(accessed through Left Shift/Alternate key). 
The cone can be called over to another area 
or left where it is. Help also appears in the 
form of shield tokens which must be 
grabbed, and a falling Llama, which adds 
an extra life (Minter has this thing about 
Llamas, you see). Blasting these little fel- 
las is a no-no. 



PERSONAL NIG^ 



Graphics are bright and cartoon-like, with 
the program utilizing the entire 512-color 
palette. Sound, as in all Minter games, is 
loud, effective and entertaining. (Why can't 
other developers handle the sound chip like 
Jeff does?) Full documentation includes 
notes and personal comments by Minter, a 
nice job, except for the Tom Thumb-sized 
print. 

Supernova releases two budget arcade 
games, Classic Invaders and Pharaoh III. 
New art-work and characters, but they're 
still just Space Invaders and Galaxian. In- 
vaders is exactly what it should be: those 
ugly faces zipping back and forth, as your 
blaster dodges their fire from beneath three 
bunkers. Then it's your turn to blast them 
to bits. Pharaoh III adds some digitized mu- 
sic and an opening story sequence before 
placing you outside of the Pyramids of 
Gizeh. Then it's rock- 'em, sock- 'em time 
as Egyptian Gods of the Dead try to wipe 
out descending spacecraft. No surprises 
here, just solid gameplay. 

Personal Nightmare makes its appear- 
ance, and it turns out that all the hype not- 
ed last time was mostly justified. Nightmare 
is a graphic/text adventure game with some 
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sound. Events are ongoing and occur as 
time passes on. So you will see different 
things depending on where you arc each 
time you play." 

Not wanting to give too much away, 
Woodruff concedes that supernatural I 
are at work here, and scenes that are very 
nasty, indeed" lie in store for the player, 

The next game out will feature Elvira, 
Mistress of the Night. You play an as 
human caught up in the strange and 
as you attempt to rescue Elvira from the 
evils haunting her medieval castle. 

Well, it's time for another sandwich. 
which means a trip out of the convention 
hall and on to a McDonald's (such a 
dent American, indeed). See you next nine 
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ast notably the animation in 
the viewing window. 

Set in England, you find that your father, 
the local vicar, has mysteriously vanished. 
Arriving at your boyhood home of Tynham 
Cross, you find the sleepy little village al- 
most unchanged, except for this nagging 
reeling that something is wrong. 

The local pub and hotel is the Dog and 
Duck, run by the nice (?) Mr. and Mrs. 
Jones. Plenty of other townsfolk are around, 
including the local constable, all friendly, 
going about their business— and concealing 
a dark secret. 

Nightmare is touted as good, clean, in- 
offensive horror containing "adult themes," 
meaning there's some violence and gener- 
al mayhem not suggested for the young (but 
probably less damaging than a Rumba film). 
The game progresses well and is easy to ac- 
cess through on-screen icons and mouse. 
You can click on the compass at the upper- 
left to move about, and in most cases, click- 
ing on objects and areas accesses them in 
an intelligent manner (clicking on a door 
means you want to open it, not put it in your 
pocket). 

Objects picked up are stored in an inven- 



tory window that is "turned on" when 
desired. Sound effects are present through- 
out and the digitized ones enhance the ee- 
rie mood as night descends. The graphics 
are quite nice as well , even Elvira's appear- 
ance with the logo is worth seeing (at least 
once; then you can bypass all of this to con- 
tinue a saved game or start a new one). 

Perhaps the only complaint is that five 
disks require a lot of swapping, since no 
RAM cache is supplied, nor is multiple 
drive use supported. This can get irksome. 
Copy-protection is all right, but why can't 
we go to a hard disk , or at least use anoth- 
er drive? These exceptions aside, Personal 
Nightmare scores well, an above-average 
adventure. 

For a bit more insight, we turn to the 
game's designer, Mike Woodruff, "There 
are a number of things that make Personal 
Nightmare different," he begins. "Game 
logic is handled by our AGOS interpreter, 
a powerful interface that makes interacting 
easy for the user. Moving around and typ- 
ing in responses is part of these games, a 
bit of a boring part since we're so used to 
it by now, but there's also some 500 se- 
quences of animation and 600K of digitized 
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based writer and photographer whose work 
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Product Information: 

CLASSIC INVADERS 
Pharaoh III 
Supernova Software 
Black Horse House 
Exmouth, England EX8 IJL 

THE HOUND OF SHADOW 

Electronic Arts UK 
Langley Business Centre 
11-49 Station Road 
Langley Nr. Slough, Berkshire 
England SL3 8YN 

PERSONAL NIGHTMARE 

HorrorSoft 

Addision Industrial Estate 

Blaydon, Tyne & Wear 

England NE21 4TE 

SUPER GRID RUNNER 

Llamasoft 

49 Mount Pleasant 

Tadley, Hants 



England 
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HARDWARE 
ST'S. . .IN STOCK!!! 

Color Monitors CALL 

Mono Monitors CALL 

SF 314 Drive CALL 

GTS 100 Drive CALL 

IB5V. Drive 199 

Navarone Scanners CALL 



MODEMS 

SX-21Z 300/1200 bps .,, CALL 

AvatexIzoOE 79 

Zoom 2400 125 



PRINTER'S DEVIL 

HI-RES GD0S 

FONT & CLIP 

ART PACKS 

IN STOCK! 

(Great for 

Desktop Publishing!!) 



ATARI ST 
SCANNERS, 

SOUND & 

VIDEO 
DIGITIZERS 

In Stock! 



• ST SOFTWARE • 



10th Frame Bowling 26 

220 ST (Terminal Emulator) ...15 

3D Breakthru 26 

ABZoo 21 

Advanced 0CP Art Studio 31 

Air Ball 26 

Air 8all Construction Set 17 

Algebra 1. 2. 3 ea 14 

Aliants 19 

All About America 41 

Alt 21 

Alternate Realily-The City 32 

Alternate Reality-The Dungeon 32 

America Cooks Series ea 9 

Architectural Design 19 

Arctic Fox 26 

Art Gallery 1, 2,3 ea 19 

Assem Pro 37 

Autoduel 24 

Award Maker 27 

Balance ot Power 32 

Bally Hoo 27 

Barbarian 25 

Bards Tale 31 

Base Two 45 

Basketball (Two on Two) 26 

Battle Droidz 25 

Battlezone 19 

Beyond Zork 34 

Biology 1, 2,3or4 ea 14 

Bismarck 28 

Black Lamp 17 

Blockbuster 27 

Boulderdash Construction Kit .17 

Brataccas 15 

Breach 27 

Bridge 5.0 24 

Bubble Ghost 24 

Business Tools 26 

Cad3D(Ver.2.0) 57 

Calamus 175 

Calamus Font Editor 62 

Captain Blood 31 

Carrier Command 29 

Certificate Maker 25 

Championship Baseball 27 

Championship Wrestling 26 

Chartpak 34 

Ctiessmaster 2000 29 

Chrono Quest 29 

Circuit Maker 2 63 

Clip Art 1.2, 3. 4. 5. 6 ea13 

Club Backgammon 23 

Color Computer Eyes 169 

Colorburst 3000 25 

Copyist Level 2 158 

Cosmic Relist 26 



Cracked 21 

Crazy Cars 25 

Cyber Control 39 

Cyber Paint 48 

CyberVCR 45 

Dark Castle 27 

Data Manager ST 46 

Daiatrieve 33 

DBMan 149 

Death Sword 13 

Deep Space 31 

Defender of the Crown 31 

Degas Elite 38 

Demon's Winter 25 

Desk Cart 67 

Digi Drum 14 

Dive Bomber 19 

Dr. Drums(DRT) 19 

Dr. Keys(DRT) 19 

Dralix 1 29 

Dungeon Master 2 18 

DynaCadd 429 

Easy Draw (Regular) 63 

Easy Draw W/ Supercharger 95 

Easy Tools 32 

Elite 22 

Empire 34 

Expert Opinion 72 

EZ Score Plus 95 

EZ Track Plus 43 

F15 Strike Eagle 24 

Falcon ST (Low. Low) . . .CALL 

Fast Basic 59 

Fast Basic M Compiler 19 

Fire and Forget 25 

First Cadd 2.0 33 

First Letters & Words 25 

First Shapes 25 

First Word Plus 59 

Flash (Greatl) 18 

Flight Simulator 2 32 

Scenery Disks ea 18 

Font Disks (Pub Part) 1-6 . . ea20 

Fonts and Borders 24 

Fontz ST 22 

Foundations Waste 26 

Fraction Action 24 

G + Plus 21 

Gateway 31 

Gauntlet 31 

Genesis (Molecular Modeler) ... 59 

GFA Basic 3.0 59 

GFA Basic Book 27 

GFA Companion 32 

GFA Compiler 38 

GFA Draft Plus 49 

GFA Quick Reference Manual .12 



SUPRA 2400 

HAYES® COMPATIBLE 

M24.95 

6' ST MODEM CABLE 9 

(With Purchase Of Supra) 



HARD DISK DRIVES FOR ST'S 



SUPRA 30 MB HARD DISK 

$ 619.95 

OTHERS CALL 



ICD 20 MB HARD DISK 



599 



OTHERS, INCLUDING TAPE BACK-UP . . . CALL 



LARGEST SELECTION IN THE U.S. 

• OVER 1000 TITLES IN STOCK • 

IF YOU SEE IT CHEAPER IN ANOTHER AD 

CALL US ANYWAY. . .WE'RE PROBABLY ALREADY 

LOWER. . .THESE ADS TAKE 3 MOS. TO GET OUT. 



GFA Ray Trace 59 

Gladiator 25 

Global Commander 28 

Gold Of The Realm 24 

Gold Rush 25 

GoldYunner 26 

Goldrunner 2 27 

Goldrunner 2 Scenery Disks ea 7 

GoneFishin' 28 

Great Chefs Vol. 1 . 2. & 3 Set ... 39 

Gridiron (Football) 19 

Gunship 26 

Hard Disk Backup 23 

Harrier Combat Simulator 34 

Heroes 01 The Lance 26 

Hi Soft Basic Pro : . . • . . 109 

High Roller 27 

Hollywood Hijinx 19 

Human Design Disk 19 

Hunt for Red October 32 

IB Copy 23 

Impossible Mission 2 27 

Indiana Jones Temple ol Doom .31 

Interlink ST 24 

International Soccer 25 

Into The Eagles Nest 24 

Inventory Manager 52 

Jet 33 

Jinxter 27 

Joust 18 

Juggler. (New Version) ... .32 

Karate Kid 2 27 

Karateka 23 

KCSLevel2 189 

Kid Progs 27 



Kinderama 24 

Kings Quest 1, 2, 3 or 4 . ea 31 

Knickerbockers 12 

LDW Power Spreadsheet 89 

Label Master Elite 26 

Lattice C 109 

Leaderboard Dual Pack 15 

Leatherneck 25 

Leisure Suit Larry 1 or 2 24 

Lock On 24 

Lords ol Conquest 13 

Lords of the Rising Sun 31 

Macro Mouse 25 

Magic Sac Pius 89 

Magic Sac Roms CALL 

Major Motion 25 

Marble Madness 27 

Mark Williams C 114 

CSD Source Debug 39 

Master Cad 119 

Match Point 25 

Mavis Beacon Teaches Typing .32 
Megamax C (Laser C) 118 

Mercenary 27 

Metro Cross 16 

Micro Kitchen Companion 26 

Microleague Baseball 36 

Microsoft Write 65 

Midi Draw 63 

Midi Maze 26 

Midi Recording Studio (DRT) 36 

Missile Command 18 

Mixed Up Mother Goose 21 

MultiDesk 19 

Music Studio 88 34 



PRINTERS 

PANASONIC ralfor latest 

1180 CALL 

1191 CALL 

1124 CALL 

Panasonic Brand Rib CALL 

STAB CslfwIaSst 

NX-1000 NEW! CALL 

NX-1000 Color CALL 

1000 Ribbon (Blk) 6 

1000 Ribbon (Cotor) 8 

OLYMPIA limply, the best! 

NLO modes use 18 x 24 matrix! 

NP-30 130 CPS 199 

NP-80s. .240 CPS ..changeable 

font cards 349 

NP-136 15inch 529 



ACCESSORIES 

ST Dust Covers from 8 

Mouse Mat 5 

Power Strip w/ Surge 15 

Deluxe Power Strip w/ Surge 24 

Drive Master 32 

Monitor Master 32 

Mouse Master 29 

EPYX 500 XJ Joystick 15 

WICO Ergo Stick Joystick 17 

Printer Stand-Heavy Duty 13 

Mail Labels 3.5x15/16-500 pk 4 

1000 pk 6 

CompuServe Starter Kit 24 

On-Line Encyclopedia Kit 36 

Printer Cable 6' 14 

Modem Cable 6' 14 

MIDI 

Midi Cables 5' to 25' CALL 

Software (Hybrid Arts etc.) ..CALL 



• ST SOFTWARE • 



N Vision 29 

NeoDesk2 33 

New Tech Coloring Book 15 

Night On The Town 22 

Ninja 14 

Oblilerator 25 

Ogre 27 

Oids 24 

Omnires 23 

Orbiter 25 

Page Stream 115 

Paint Pro 33 

Paintworks 14 

Paperboy 25 

Partner Fonts 21 

Partner ST 43 

PC Ditto 2 Low CALL 

Perfect Match 27 

Personal Pascal 66 

Phantassie 1, 2 or 3 ea26 

Phasar3.0 58 

Pinball Wizard 24 

Pirates ol the Barbary Coast 17 

Planetarium 33 

Platoon 25 

Police Quest 1,2 32 

Pool of Radiance 25 

Prime Time 27 

Print Master Plus 26 

Prison 25 

Pro Copy . (Latest Ver.) ..28 

Publisher ST 79 

Ball 21 

Quantum Paint Box 31 

Quink 11 

Rastan 25 

Read & Rhyme 24 

Renegade (Outcast) 14 

Road Runner 26 

Roadwars 22 

Rockford 22 

Santa Paravia 19 

Scan Art 32 

Scruples 29 

SDI 13 

Shadow 18 

Shadowgate 34 

Shard of Spring 27 

Shulfleboard 19 

Silent Service 24 

Sinbad 19 

Sky Fox 14 

Space Quest 1 or 2 ea31 

Space Quest 3 37 

Spectrum 512 41 

Spelling Bee 19 

Spiderman 7 



Spy vs Spy 3 (Arctic Antics) 19 
ST Disk Drives Inside & Out 18 
ST Gem Programmers Ref Man . . 15 

ST Internals Book 15 

ST Intro to Midi Book 15 

ST Machine Language Book 15 

ST Pool 21 

ST Talk Pro 17 

STAC , 44 

STOS 39 

Star Fleet 1 37 

Star Raiders 19 

Slarglider2 26 

Stellar Crusade 36 

Strip Poker 2 25 

Sub Battle Simulator 25 

Sundog 25 

Super Base Professional 174 

Super Slar Ice Hockey 31 

Swift Calc St 46 

Take Note 52 

Tanglewood 25 

Terror Pods 25 

Test Drive 1 or 2 24 

Test Drive 2 Extra Disks ea 14 

Three Stooges 34 

Thunder 26 

Time Bandit 24 

Top Gun 11 

Trailblazer 32 

True Basic 52 

Tune Smith (DRT) . 95 

Tune Up 31 

Turbo ST 32 

TV Sports Football 31 

Typhoon Thompson 21 

Uninvited 31 

Universal Item Selector 12 

Universal Military Sim 31 

Vampires Empire 20 

Vegas Craps 24 

Vegas Gambler 23 

Video Titleing 22 

Vip Professional (Gem) 129 

War Ship 38 

Wargame Construction Set .22 

Winter Challenge It 

Wizards Crown 25 

Word Perfect 1 59 

Word Up 47 

Word Writer ST 46 

World Games 12 

World Karate Championship 19 
WWF Microleague Wrestling 29 

Xevious 19 

Zak McKracken 27 

Zany Golf 26 



HOURS: M-F 9 a.m.-9 p.m. 
SAT 9 a.m.-5 p.m. 



EST 



ALL 50 STATES CALL TOLL FREE 

1-800-255-5835 



For Order Status or 
Tech. Info, Call (513) 294-6236 



TERMS AND CONDITIONS 

• NO EXTRA CHARGES FOR CREDIT CARDS! • Minimum order $15 • COD: Yes, it all Shipping Charges are PRE-PAID • SHIPPING: Hardware, minimum $4; Software and most accessories, minimum $3 • Next 
day shipment available at extra charge • We ship to Alaska. Hawaii. Puerto Rico (UPS Blue Label Only). APO and FPO • Canadian orders, actual shipping plus 5%. minimum $5 • Ohio resiOenls add 6% sales 
tax • Please allow 2 weeks for personal or company checks to clear • All defective products require a return authorization number to be accepted for repair or replacement • No free trials or credit • Returns sub- 
ject to 15% re-stocking charge • Due to changing market conditions, call toll free for latest price and availability of product. FOR YOUR PROTECTION. WE CHECK ALL CREDIT CARD ORDERS FOR FRAUD 



CIRCLE #111 ON READER SERVICE CARD. 



8. 



MO 1 
PB 2 
PS 3 

ZD 4 
IN 5 



REM XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 
REM * MEMORY MATCH * 

rem * by Joe Brzuszek * 

REM * * 

REM * COPYRIGHT 1989 * 
II 6 REM * BY ANALOG COMPUTING * 

MU 7 REM XXXXKXXXXXXXKXXXXXXXXXXXXXXXXX 

NN 8 REM 

HT 10 POKE 566,143iP0KE 567, 231 : RESTORE 9 

eoo:G05UB 8000 

PT 15 POKE 53277,6 

ZA 20 POKE 53248, X ! T=USR (ADR CMMS) , ADR (PLS 

),P1+Y,V4) :T=U5R (ADR (MMS), ADR ("¥»¥¥"), 

P1+Y,U4) :T=STICK(S) 
HS 30 X=X+20*((T=7)-(T=1D) ; Y=Y+24*( (T=13 

)-(T=14)) :T1=STRIG(S) :IF X>53 AND X<19 

5 AND Y>61 AND Y<111 AND Tl THEN 28 
HI 40 IF Y<62 THEN Y=62 
XA 50 IF Y>110 THEN Y=110 
XG 60 POKE 53278, Z:T=USR (ADR (MMS), ADR (PLS 

),P1+Y,V4) :IF X<54 THEN X=54 
KT 70 IF X>194 THEN X=194 
IE 80 IF NOT Tl THEN POKE 53277, U2:IF PE 

EK (53252) THEN 100 
TO 90 GOTO 15 
CO. 100 SOUND Z,V1,U2,V12:S0UND Z,Z,Z,Z:X1 

=INT CO . 25* CX-54) ) + VI ! Y1=B . 125* CY-62) +6 

: K= C CXl-yi3 /5+Ul+g8* CY-623 /24J 
NZ 110 POKE 77,Z:I2=A5C(MIXS(K)) :I=M1+6*I 

2 : T=U5R CADR (MMS) , ADR ("*»*»") , Pl+Y , V4) : 

IF MIXS(K,K)=" " THEN 15 
RD 120 POSITION XI, Yli? CARDS CI, 1+2) ; "+«■+ 

«■"; CARDS (1+3, 1+5) 
SC 138 TH=TN+V1:IF TN=V2 AND K1=K THEN TN 

=V1:G0T0 15 
RD 140 ON NOT SO GOSUB 500+12*20 SlF TN=U 

hi THEN K1=K: 11=1 :X2=XliY2=YIi GOTO 15 
JL 150 N=N+UiiTN=ZiIF 11=1 THEN 300 
SB 180 FOR I=Z TO 425:NEXT I : POSITION X2, 

Y2i? ClSiPOSITION XI, Yl:? CIS: ON NOT 

PL GOTO 15!S=5+Ui:IF S=U2 THEN S=Z 

XG 190 POSITION 6,V2:IF S=Z THEN ? " \dW-XM 

\M1>> PLAYER 2":P0 KE 704,6 0;G0T0 15 
DM 200 ? "PLAYER 1>> 3SSE3E" ! POKE 784 

,172: GOTO 15 
YI 300 RESTORE : MIXS CK, K) =" " : MIXS (K1,K1) 

— II II 

DE 310 TRAP 320:READ IiFOR K=14 TO 5 STEP 
-VliSOUND Z,I,U1B,K:NEXT KiGOTO 310:D 

ATA 60, 68, 47, 48, 47, 48, F 
TA 320 FOR K=Z TO 30:NEXT K: SOUND Z,Z,Z,Z 

:S1=S1+U2!IF S THEN S2=S2+V2:S1=S1-V2 
VC 330 POSITION 6,3i? 51;">> ";S2 
DA 340 FOR I=Z TO 300:NEXT I:POSITION XI, 

Yli? " +++«■ "iPOSITION X2,Y2i? " 
+«■«-«• "!IF Sl+S2<24 THEN 15 
NV 350 FOR I=Z TO 258:P0KE 709,I:POKE 532 

79,Z:P0KE 53279, WSiNEXT I 
UR 360 POSITION Z,Z:? "[E+» IT TOOK YOU 

";K; M TURNS. PRESS OUtl^ ► ► K+FOR A NE 

H GAME." 
R« 370 ON PEEK(53279)=7 GOTO 370:GOSUB 80 

60: GOTO 15 
EA 500 FOR J=V12 TO V4 STEP -Ul: FOR H=J T 

Z STEP -liSOUND Z, 200, V18, H : NEXT H:N 

EXT J:RETURN 

ra 520 for j=15 to z step -0.5:sound z,u2 

,u2,u8:s0und z,z,z,z!next jisound z,z, 

z,z:return 
hn 548 for j=u12 to z step -2:f0r h=u12 t 

z step -1.5:s0und z, 19+h*2, u10, j : hex 
it h:next jisound z,z,z,z:return 
os 560 sound u2,19,u4,u4:f0r h=u1 to v2:f 

or j=z to 30is0und z, vz, vz, u12 ! next j: 

sound z,z,z,z:next h 
jp 570 sound u2,z,z,z:return 



ZC 588 FOR J=15 TO Z STEP -1.5:50UND Z,J, 

U18, JiNEXT JiSOUND Z, Z, Z, Z I RETURN 
AZ 660 FOR J=U12 TO Z STEP -8.4:S0UND Z,l 

85,1118, JiNEXT JiF8R J=U12 T8 Z STEP -8 

,45iS0UND Z, 132, V1B, JiNEXT JiRETURN 
HQ 620 FOR H=15 TO Z STEP -UliSOUND Z,H,U 

10,HiS0UND Z,Z,Z,ZiNEXT HiRETURN 
JB 640 FOR J=50 TO 60 STEP 6SS0UND Z,J,U1 

0,U8iNEXT JiFOR J=60 TO 30 STEP -04:S0 

UND Z,J,W10,M8iNEXT JiSOUND Z,Z,Z,Z 
ZM 650 RETURN 
YC 660 SOUND Z, 49, VS, U8 i SOUND V1,50,U8,U8 

iFOR J=l TO 388!NEXT JiSOUND Z,Z,Z,Zi5 

OUND Vl,Z,Z,ZiRETURN 
FR 688 RESTORE 698iTRAP 698 
TM 685 READ 12, JiFOR H=Z TO JiSOUND Z,I2, 

V10,U12iNEXT HiGOTO 685 
FQ 690 RETURN iDATA 91,8,108,8,136,20,108 

, 28, 91, 28, 68, 30, 8, 8, F 
GL 788 F8R J=15 TO Z STEP -U2:S0UND Z,U2, 

U4,U12iF0R H=Z TO JiNEXT HiSOUND Z,U2, 

U8,V12iNEXT JiSOUND Z, Z, Z, Zi RETURN 
GY 728 F8R J=15 TO Z STEP -8.5iS8UND Z,29 

,U1B, JiNEXT JiSOUND Z,Z,Z, Zi RETURN 
UJ 8000 READ Vl,g2,Y4,V8,V18,gi2:P=PEEKCl 

86J-V8iP0KE 186,PiDIM MMS (63) , PLS (9) , C 

ARDS C180) , MIXS (24) , CIS (13) 
SZ 8010 GRAPHICS ZiPOKE 559, Z i DL=PEEK C560 

)+PEEK(561)*256iP0KE DL+V8,138 
GY 8020 POKE DL+19,65iP0KE DL+28, PEEK C568 

) SPOKE DL+21,PEEKC561) :P1=P*256+512 1 FO 

R X=Z TO 128iP0KE Pl+X,ZiNEXT X 
EZ 8848 FOR X=Z TO 6: READ CARDS i Y=USR CADR 

CMMS) , ADR CCARDS) , CP+V4)*256+X*100, LEN ( 

CARDS)) iNEXT X 
PF 8058 READ CARDS i Y=USR CADR CMMS) , ADR CCAR 

D$) , 1536 , LEN CCARDS) ) i X=USR C1536) 
10 8868 POKE 53248, ZiPOKE 1563,224:F0R X= 

9 TO 18SP0KE DL+X,7iNEXT XiPOKE 788,36 

SPOKE 789,42iP0KE 718,V2iP0KE 711,48 
CO 8B78 POKE 82,V1;P0KE 752, Vli? "K>M-MEM 

ORY MATCH++Q>> by+Q> Joe Brzu 

FO 8871 PLS="Q Qffinia":IF PL THEN PL$="B" 
UM 8872 MIXS="[!E1":IF SB THEN M IX$=" [JI3a" 
AX 8888 POKE 8 4,5:? "OPTION Q BJHEB ";M IX 

S;? "S313B Q ";PL$:? "start Q GTJED S 

GEH'-SPOKE 559,34 
ZE 8898 X=PEEKC53279) :0N X=7 GOTO 8888 :S8 

UND Z,29,U18,V18iS0UND Z,29, VZ, V18 ! SOU 

ND Z,Z,Z,Z:ON X=6 GOTO 8158 
FX 8188 ON X=3 GOTO 8128 ! PL=PL+U1 : PLS="B 

HUHJE-'ilF PL=U2 THEN PL=ZiPLS="D HE 

saaa ■■ 

TZ 8118 G8T0 8888 

RM 8128 SO=SO+UiiMIXS="[iTJi":IF S0=M2 THEN 

SO=Z!MIXS="[iE " 
UF 8130 GOTO 8888 

YG 8158 POKE 559,ZiF0R X=9 TO 18iP0KE DL+ 
;X,5iNEXT XiFOR X=U1 TO 25 i CARDS CX) =CHR 

SCX) iNEXT XiPOKE 1563, P+U4 
C¥ 8160 PLS="J-<^U»:ClS="Hil+<-*+(3J!*+t" 
XL 8170 POKE 708,68!POKE 7B9,26iP0KE 711, 

214! FOR X=Z TO 11 iFOR Y=U1 TO VZ: SOUND 
Z,5,U8,U8iS0UND Z,Z,Z,Z 
RY 8180 X1=INTCRNDCU1)*CLENCCARDS)-V1))+U 

1 i Y1=ASC CCARDS CXI) ) : CARDS CXI) =CARDS CXI 

+U1) :MIX$CY1,Y1)=CHRS(X) SNEXT YjNEXT X 
VC 8200 ? "OKMEMORY MATCH**nK lilT:YJ 1:W\ Y 

► PLAYER 2IQKB^ 0*+":POKE 559,46 
EI 8210 FOR Y=Z TO U2 ! FOR X=V1 TO U8i? CI 

S ' ! NEXT X ! ? "^+" ! NEXT Y 
Yft 8220 POKE 704,60:POKE 54279, PiPOKE 532 

77,V2iP0KE 623,ZiX=114iY=62iSl=ZiS2=Z: 

N=Z : RETURN 
GR 90O0 DATA 1,2,4,8,10,12 



NOVEMBER A.N.A.L.O.Q. Computing 



LISTING 2: BASIC 



!IF Yl>15 THEM 
ilF Y2>15 THEN/ 
i=LINE+10 



AB 1 REM MEMORY MATCH - LI5TING2 

M5 2 REM by Joe D. Brzuszek 

PZ 3 REM creates lines 8630, 8190, 9010-3 

080 

4 REM and saves theH in "DiMEM.LST" 

5 REM 

6 REM ENTER "DiMEM.LST" to load 

7 REM 

G IB DIM HSCIOIJ :LINE=6O0:LAST=780 
SN 20 GRAPHICS Z.'POKE 752, li POKE 710,2 
Sg 30 OPEN ttl, 8, Z, "DiMEM.LST":? "OPENING 
DiMEM.LST FOR OUTPUT" i TRAP 380 
40 READ HSilF LENCHSlOlOO AND LINEOL 

ast then ? "data length error in line 
";line:goto 400 

50 ln=peekc183j+peekc1843*256iif ln<>l 
ine then ? "line ";line;" is missing!" 

iGOTO 400 

60 ? "CHECKING LINE "; LINE: FOR X=l TO 

99 STEP 2iYl=ASCCH$CX,XJl-48iY2=ASCCH$ 

£X+l,X+133-48 

IW 78 IF Yl>9 THEN Yl=Yl-7 
390 

80 IF Y2>9 THEN Y2=Y2-7 
390 

98 PUT ttl, Y2+Yl*16i NEXT XiLINE 
:G0T0 40 

380 IF PEEKC1953=5 AND LINE=LAST THEN 
? "NO ERRORS FOUND, BUT SAVE LISTING2 
AS A BACKUP JUST IN CASE!":G0T0 400 
390 ? "ERROR AT LINE ";LINE 
400 ? "QCLOSING FILE"!P0KE 752,Z:END 
660 DATA 383033304D4D243D22686885CC688 
5CB6885CE6885CD681865CE85D0681865CD85C 
F9882E6D0AO0OBlCB91CDE6CBDeO2E6CC 
610 DATA E6CDD0O2E6CEA5CDC5CFD0EAA5CEC 
5D0D0E460229B3831393O43415244243D225D5 
E5FOOO102630405O607O8898A8B8C8D8E 
620 DATA 0F1011121314ADAEAFB0B1B233343 
5363738B9BABBBCBDBE3F40414243444546474 
8494A4B4C4D4E4F50515253545556D7D8 
_ 630 DATA D9DADBDC229B39303130444154410 
O66000O0O0O0OOeFFD5DFDDDDDDDDDDFF55FF5 
5FFD7D7D7FF57F77777777777DDDDDDDD 

ZU 640 DATA DDDFD5FFD7D7D7FF55FF55FF77777 
r 77777F757FFAABFBABBBBBBBBBBAAFFAAFFAAB 
EBEBEAAFEAEEEEEEEEEEEBBBBBBBBBBBA 
650 DATA BFAABEBEBEAAFFAAFFAAEEEEEEEE9 
B3330323044415441EEAEFEAAeOO0e303OB2A0 
9050OF0FC3FFFFF7F5FO0000OOOC0F0FC 

IR 660 DATA FCO505050100O0OA0857555555554 
e8A88FFFF7F7F5C4C8088888888888862e2828 
OOO28AAAAAAAAAA8000e0OOOO808O8O02 

QD 670 DATA O2O202O10A2AO0AAAAAAAA55AAAA0 
28080808040 AOA88O9B3930333O444154410OO 
AO33A3FFFAFAF000OFOFFFFFFFFFFOO00 

LA 680 DATA Q0O0COF0FCFF2B0BO203CF3CC300E 
AEAFBC00O0FO30CBFFCF0FC3CFCF03O0OOO0OO 
O0OO00303OOO03030FCFCFFFF00O0OOO0 

tP 690 DATA O0000O0Q0F0E3A3A3A0E03OOFFFFF 
FFFBFAFFFe0CeC0FOF0FeC0O0O0e000O00O9B3 
930343044415441OO00O30FOO3C283C3C 
700 DATA FFFFFF0OOO0O00000OC0F03FFFFCF 
0O00O0300FF3C3C3C3CFFFF3CFCFF3F0F0O00C 
O00FFEEFBEEFBEEFBEEFDEEBDEEBDEEBD 
710 DATA EE55AA55AA55AA55AAFFAA55AA55A 
A55AAFDAA55AA55AA55AA55AA55AA55AA55AA0 
OO20A2AAA2AOAO29B3930353844415441 
720 DATA AAAAAAAO0080AOA8AAA000O00OOOO 
0000000000200200000 A A2 AAA A0000GO000O08 
000000000000000000000000000000038 
730 DATA 3C3F3F3F33330O00000000C0C0C00 
0080000OF3F3F0F3O303030F0F0FOCOC0COOO0 
00600000O0000000OO5171F5F0000007F 
TH 740 DATA 9B3930363044415441FFFEFFFFOOO 
00000F0FCBCFF5F5F571715050000FFFFFFFF7 



SN 
NK 
OF 
NM 



DG 



KC 



DL 



LV 
LG 



TZ 



OE 
XT 
JF 



JC 



CB 



FA 



BX 



F55550OFFFFFFF4D450OOOOO33CFFFFFF 
IL 750 DATA FFFF3CC2F23238E8E8A8288A08A82 
2EEEE2222O228OAA22A8A202OAAA2AOA08OO0O 
000 A8A0800 00000 0OO03F3D3FFEFEFEFE 
NC 760 DATA 3EC6FF7FDDBFAEAE8C9B393037304 
4415441FCDC7FEFAFAFAFAC3F3FFFFFFDF2F33 
FAEEEFF226655FFFFBCFFFF3F4F63F3FC 
770 DATA 010707070707070755F7F7F7F7F7F 
7F754F5F5F5F5F5F5F51595955140444011555 
555555555410055555545011101449B39 
AD 780 DATA 3038304441544168A9068D8102A91 
18DOee2A9CO8D0ED46O48A9868DOAD48D18DOA 
9E08D09D468489B 
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I 





NOVEMBER A.IM.A.L..O.Q. Computing 



FEATURE 




NOVEMBER A.IM.A.L.O.Q. Computing 



FEATURE 



1838 DATA 148,59,168,4,32,131,59,32,12 

8,55,41,127,281,49,48,10,2063 

1840 DATA 201,58,16,6,141,177,54,76,11 

1,68,41,95,162,4,100,55,2714 

1850 DATA 95,56,221,104,54,240,6,202,1 

6,248,76,77,55,138,18,170,6485 

1868 DATA 189,109,54,133,212,232,189,1 

89,54,133,213,188,212,8,162,16,8505 

1878 DATA 169,7,157,66,3,169,8,168,32, 

156,59,76,86,228,32,181,6256 

1880 DATA 55,189,216,54,141,48,2,189,2 

17,54,141,49,2,76,175,55,4923 

1890 DATA 169,178,141,208,2,141,198,2, 

169,12,141,197,2,169,34,141,6619 

1900 DATA 47,2,96,169,8,240,248,169,13 

6,133,106,32,178,73,32,181,8155 

1910 DATA 55,133,82,169,64,133,16,141, 

14,210,96,165,203,162,124,32,8052 

1928 DATA 219,55,32,185,55,169,124,166 

,283,133,213,134,208,169,64,133,1836 

1938 DATA 212,133,287,168,8,162,2,177, 

212,145,207,200,208,249,230,213,7154 

1948 DATA 230,208,202,16,242,160,192,1 

98,212,198,287,177,212,145,207,136,671 

8 

1958 DATA 288,249,96,165,206,288,6,32, 

185,55,32,226,62,32,41,57,4248 

1960 DATA 165,206,208,2,230,206,32,67, 

57,32,175,55,32,242,56,32,4889 

1978 DATA 88,57,173,252,2,201,255,288, 

34,173,31,288,281,3,248,21,9828 

1980 DATA 201,5,208,3,76,47,55,281,6,2 

08,3,76,7,62,173,220,5635 

1990 DATA 2,201,17,208,221,32,2,57,76, 

38,56,32,231,56,232,208,7623 

2888 DATA 203,32,128,55,162,12,221,119 

,54,248,53,282,16,248,96,56,8161 

2810 DATA 91,57,166,84,224,23,288,18,2 

01,155,240,46,166,85,224,39,9726 

2020 DATA 240,79,166,85,224,39,208,9,2 

01,155,240,5,32,244,62,169,9663 

2030 DATA 155,72,169,0,170,168,32,156, 

59,169,11,157,66,3,169,27,4259 

2848 DATA 32,86,228,104,32,164,56,76,3 

0,56,166,85,240,3,76,194,6570 

2050 DATA 56,169,29,76,146,56,72,169,2 

55,162,2,157,178,2,202,16,7206 

2060 DATA 250,169,0,168,170,32,156,59, 

169,11,157,66,3,104,76,86,4887 

2070 DATA 228,32,244,62,32,200,56,76,3 

0,56,32,228,56,177,212,72,7062 

2080 DATA 32,154,57,184,133,93,24,185, 

128,160,0,145,212,96,169,64,7389 

2098 DATA 133,212,165,203,133,213,160, 

0,96,162,5,221,132,54,240,127,312 

2100 DATA 202,16,248,96,169,8,141,31,2 

08,169,255,141,252,2,169,8,9488 

2118 DATA 141,220,2,96,120,32,33,60,16 

9,64,133,212,133,213,32,9,6087 

2120 DATA 64,165,176,141,186,54,169,58 

,141,280,2,141,198,2,169,0,6627 

2130 DATA 141,197,2,162,2,32,144,55,32 

, 128, 55, 32, 29, 60, 162, 0, 1173 

2140 DATA 32,144,55,169,216,141,186,54 

,169,0,133,19,169,7,160,233,8596 

2150 DATA 162,61,32,92,228,162,3,189,1 

56,54,157,197,2,282,16,247,9624 

2160 DATA 162,1,181,186,149,84,202,16, 

249,96,162,3,189,197,92,57,8928 

2178 DATA 87,58,2,157,156,54,202,16,24 

7,162,1,181,84,149,186,202,879 

2188 DATA 16,249,96,138,133,212,18,24, 

181,212,170,189,138,54,133,212,837 

2190 DATA 232,189,138,54,133,213,168,0 

,232,189,138,54,48,10,177,212,9448 

2200 DATA 24,105,2,145,212,76,30,56,17 

7,212,56,233,2,76,141,57,6436 

2210 DATA 169,0,133,84,133,85,230,85,1 

69,126,76,164,56,32,173,57,6847 

2220 DATA 76,93,59,160,132,169,71,162, 

152,32,164,59,169,0,133,207,8470 

2230 DATA 133,208,166,207,169,128,157, 

69,131,224,14,240,5,169,0,157,8765 

2240 DATA 70,131,32,128,55,166,207,201 

,155,208,7,224,3,48,42,76,6305 



2250 DATA 168,58,41,127,201,27,240,33, 

224,0,208,34,201,58,208,2,7557 

2268 DATA 169,49,201,49,48,204,201,59, 

16,200,32,139,58,238,207,169,616 

2270 DATA 58,32,139,58,230,207,76,188, 

57,104,104,76,47,55,201,126,7490 

2280 DATA 208,29,198,207,169,32,32,139 

,58,165,208,240,2,198,208,165,2239 

2290 DATA 207,201,1,208,157,198,207,16 

9,32,32,139,58,76,188,57,281,9032 

2300 DATA 46,208,20,166,207,224,3,48,1 

37,166,288,208,133,32,139,58,9137 

2310 DATA 230,207,238,208,76,188,57,20 

1,42,240,25,201,63,240,21,201,1166 

2320 DATA 49,48,241,201,58,16,3,76,94, 

58,41,95,201,65,88,58,3795 

2330 DATA 83,59,48,228,201,91,16,224,1 

66,287,224,10,208,13,166,208,1894 

2340 DATA 208,9,72,169,46,32,139,58,10 

4,230,207,166,207,224,14,240,2699 

2350 DATA 199,166,208,224,4,240,193,32 

, 139, 58,230, 207, 165, 288, 240, 184, 5914 

2368 DATA 230,208,76,188,57,166,287,15 

7,161,54,56,233,32,157,69,131,9118 

2378 DATA 224,13,240,5,169,0,157,70,13 

1,96,157,161,54,169,0,157,7242 

2380 DATA 69,131,32,33,60,169,31,32,16 

4,56,32,220,56,177,212,72,7292 

2390 DATA 32,154,57,104,160,8,145,212, 

32,104,60,162,32,32,123,59,4413 

2400 DATA 162,32,160,160,169,54,32,148 

,59,164,209,32,131,59,152,48,6754 

2418 DATA 108,162,32,165,210,157,66,3, 

160,58,169,132,32,148,59,160,7472 

2420 DATA 6,169,0,32,156,59,32,86,228, 

152,48,81,162,32,165,210,8399 

2438 DATA 157,66,3,281,11,248,18,160,5 

,185,58,132,217,226,54,208,673 

2440 DATA 5,136,16,245,48,3,76,80,62,1 

60,192,169,3,32,156,59,5244 

2450 DATA 160,64,169,132,32,148,59,32, 

86,228,152,16,3,76,67,59,3468 

2460 DATA 160,156,169,54,162,32,32,148 

,59,168,4,169,0,32,156,59,4900 

2470 DATA 32,86,228,152,48,7,165,286,2 

88,2,238,206,96,32,195,59,9510 

2488 DATA 169,253,32,164,56,168,157,16 

9,72,162,203,32,164,59,84,59,7645 

2490 DATA 79,60,32,128,55,184,184,169, 

8,133,299,162,32,32,123,59,5574 

2500 DATA 32,29,60,32,220,56,177,212,1 

33,93,32,162,57,165,209,201,1094 

2510 DATA 8,248,3,76,5,56,76,47,55,169 

,12,157,66,3,76,86,2197 

2520 DATA 228,169,3,157,66,3,152,157,7 

4,3,169,8,157,75,3,76,3298 

2530 DATA 86,228,157,69,3,152,157,68,3 

, 96, 157, 73, 3, 152, 157, 72, 5653 

2548 DATA 3,96,132,212,133,213,134,207 

,169,139,133,208,169,8,177,212,3423 

255B DATA 201,96,240,12,145,207,200,20 

8,245,230,213,230,208,76,176,59,5702 

2560 DATA 96,56,233,100,72,162,0,56,23 

3,10,48,3,232,208,249,142,343 

2578 DATA 170,72,169,8,24,105,10,202,2 

08,258,141,171,72,104,56,237,826 

2580 DATA 171,72,141,171,72,162,1,189, 

170,72,24,105,144,157,170,72,8399 

2590 DATA 202,16,244,169,8,133,209,96, 

169,232,162,54,160,4,32,6,6284 

2688 DATA 60,76,167,57,133,207,134,208 

,152,133,209,24,195,3,133,210,97 

2610 DATA 160,11,177,207,153,186,71,13 

6,16,248,96,162,0,248,2,162,9223 

2620 DATA 2,142,248,2,96,162,16,32,123 

,59,169,2,133,82,173,223,8074 

2630 DATA 54,133,106,32,179,73,169,64, 

141,190,2,169,0,141,182,2,6334 

2640 DATA 173,91,60,133,12,173,92,60,1 

33,13,172,224,54,174,88,60,7134 

2650 DATA 75,61,225,54,169,7,32,92,228 

,108,10,0,32,0,0,169,1947 

2660 DATA 90,133,12,169,68,133,13,76,4 

4,55,169,0,133,186,133,187,7650 

2670 DATA 96,169,64,133,212,165,204,13 
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3,213,162,2,168,8,152,133,209,1316 

2688 DATA 145,212,288,288,251,238,213, 

282 , 16, 246 , 169 , 128,133 , 213,173 , 177, 656 

8 

2698 DATA 54,24,185,96,141,29,73,162,4 

8,169,8,168,32,141,61,162,6148 

2788 DATA 32,32,123,59,162,32,169,3,15 

7,66,3,169,6,157,74,3,3178 

2718 DATA 168,176,169,54,32,148,59,32, 

86,228,152,16,3,76,95,61,4884 

2728 DATA 162,32,169,5,157,66,3,168,8, 

169,4,32,148,59,168,28,3543 

2738 DATA 169,8,32,156,59,32,86,228,15 




FEATURE 



,248,3,24,185,128,133,93,6278 
3188 DATA 96,32,242,56,169,188,133,287 
,168,14,185,41,73,24,185,128,7785 
3118 DATA 145,287,136,16,245,288,132,2 
8,165,287,141,33,63,165,208,141,1657 
3128 DATA 34,63,165,28,281,192,248,224 
, 173, 252, 2, 281, 255, 24B, 68, 63, 4698 
3138 DATA 97,63,243,76,242,56,128,169, 

,133,212,165,285,133,213,162,4888 
3148 DATA 71,169,8,168,145,212,200,208 
, 251, 238, 213 ,282,16, 246 , 88 , 96,5116 
3158 DATA 226,2,227,2,72,63,8,64,49,64 
,128,169,287,133,212,169,185 
3168 DATA 67,133,213,169,64,133,287,16 
5,284,133,288,162,2,168,8,177,1191 
3178 DATA 212,145,287,288,288,249,238, 
213,238,288,282,16,242,198,212,198,977 
1 

3188 DATA 287,168,192,177,212,145,287, 
136,288,249,88,96,196,64,218,64,3558 
3198 DATA 289,218,218,218,218,218,218, 
218,218 , 218 , 218,218,218 , 218 , 197, 236 , 19 
70 

3200 DATA 64,250,64,252,221,128,168,16 
5,172,176,128,173,165,174,181,128,5469 
3218 DATA 221,252,8,65,48,65,289,218,2 
18,218,218,218,218,218,218,218,8992 
3228 DATA 218,218,216,218,218,218,218, 
218,218,218,218,218,218,218,218,218,17 
98 

3238 DATA 216,218,218,218,218,218,218, 
218, 218, 218, 21B, 218, 218, 197, 252, 87, 276 
3248 DATA 65,121,65,252,252,8,163,175, 
174,188,178,175,172,0,11,0,8376 
3258 DATA 228,221,222,223,8,29,8,35,11 
7,114,115,111,114,8,189,111,5687 
3268 DATA 118,181,189,181,118,116,127, 
65,128,65,252,252,167,65,32,66,9181 
3278 DATA 252,252,8,179,168,166,188,15 
,163,188,178,172,8,11,8,228,8921 
3288 DATA 221,8,29,8,35,184,97,118,183 
,181,8,115,99,114,181,181,5277 
3298 DATA 110,0,99,111,108,111,114,0,2 
52,252 , , 179,168,166 , 188,15 , 529 
3388 DATA 163,188,178,172,8,11,8,156,1 
58,8,29,8,35,184,97,118,3226 
3318 DATA 183,181,8,98,111,114,186,181 
,114,8,99,111,188,111,114,8,4869 
3328 DATA 252,252,8,179,168,166,188,15 
,163,188,178,172,8,11,8,175,8251 
3338 DATA 176,8,29,8,35,184,97,118,183 
,181,8,116,181,128,116,8,4813 
3348 DATA 188,117,189,185,118,181,118, 
14,252,252,71,66,72,66,252,252,2588 
3358 DATA 88,66,99,66,128,175,176,188, 
169,175,174,128,8,29,8,48,6252 
3368 DATA 37,44,48,8,189,181,118,117,1 
11,66,112,66,252,252,128,66,9829 
3378 DATA 139,66,128,179,165,172,165,1 
63,188,128,8,29,6,45,97,185,6878 
3388 DATA 118,8,189,181,118,117,151,66 
,152,66,252,252,168,66,181,66,1657 
3398 DATA 128,179,188,161,178,188,128, 
128,8,29,8,51,97,118,181,8,4288 
3488 DATA 115,99,114,181,161,116,191,6 
6, 192, 66, 252, 252, 231, 66, 49, 67, 14B7 
3418 DATA 252,218,218,218,218,218,216, 
218,218,218,218,218,218,218,216,218,28 
28 

3428 DATA 218,218,218,218,218,218,218, 
218,218,216,218,216,218,218,218,218,19 
88 

3438 DATA 216,218,215,218,218,216,216, 
218,195,8,8,8,8,8,252,223,188 
3446 DATA 48,58,37,51,51,8,33,46,57,6, 
43,37,57,6,52,47,8468 

3458 DATA 8,35,47,46,52,41,46,53,37,22 
2,252,61,67,89,67,218,7764 
3460 DATA 210,210,210,218,218,218,218, 
218,218,216,218,218,218,218,218,218,26 
28 

3478 DATA 218,216,218,216,218,218,218, 
218,218,216,218,195,3,68,18,68,2619 
3486 DATA 72,128,188,169,188,172,165,1 
28,128,173,161,171,165,178,128,268,559 
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60 

3868 DATA 255,182,73,212,73,32,178,73, 

128,169,8,148,47,2,132,283,7944 

3878 DATA 169,112,133,284,165,88,133,2 

87, 165, 89, 133, 288, 162, 2, 177, 283, 3789 

3880 DATA 145,287,288,288,249,238,284, 

230,288,282,16,242,177,283,145,207,936 

6 

3898 DATA 288,192,192,208,247,162,8,17 

7,283,157,197,2,200,232,224,4,4365 

3988 DATA 288,245,169,34,141,47,2,88,9 

6,162,96,169,12,157,66,3,5906 

3910 DATA 32,86,228,162,96,169,3,157,6 

6,3,169,28,157,74,3,169,6862 

3928 DATA 0,157,75,3,169,210,157,68,3, 

169,73,157,69,3,76,86,6878 

3938 DATA 228,83,58,155,226,2,227,2,18 

2, 73, 176, 123, 255, 123, 128, 128, 1930 

3940 DATA 128,128,128,188,169,188,172, 

165,128,173,161,171,165,178,128,128,51 

87 

3950 DATA 128,128,128,128,226,249,128, 
172,225,242,242,249,128,162,236,225,12 
93 

3968 DATA 227,235,128,128,128,128,128, 
128,128,128,128,176,242,229,243,243,87 
18 

3978 DATA 128,187,175,176,188,169,175, 
174,189,128,230,239,242,128,168,165,87 
89 

3980 DATA 172,176,128,179,227,242,229, 
229,238,128,128,128,128,128,32,128,397 
6 

3998 DATA 63,128,112,112,112,66,64,128 

,2,2,2,2,2,2,2,2,7721 

4B88 DATA 2,2,2,2,2,2,2,2,2,2,2,2,2,2, 

2,65,5280 

4O10 DATA 32,128,226,2,227,2,0,55,0,0, 

0,0,0,0,0,0,6571 
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o REM Title Maker Listing 2 
HV 1 REM Save as TITLMAKR.BAS 
DM 2 REM Creates binary file to retain 
MS 3 REM Title screen without READY 

» 4 REM pronpt and RUN "DiAUTORUH.BAS" 
Pv 5 REM /Append to Title screen file. 
PW 10 DIM F$C14) :F$="D1:AUT0B00T.TM" 
XL 20 GRAPHICS OiPOKE 710,34:POKE 709,42 
OL 30 TRAP 20:? :? "What drive to write ■■ 

:? F$C4);" to > ";:INPUT I 
TI 40 IF I<0 OR I>9 THEM 20 
LS 50 TRAP 48000:F$C2,2)=CHR$CI+48) SCLOSE 

81: OPEN ttl, 8, 0,F$! RESTORE 
SX 60 POKE 752,1:? :? 

UK 70 FOR 1=1 TO 120: READ BYTE:? I;"t" 
DG 88 put »i,byte:next I:? ■■*■»•» bytes" 
MP 98 ? :? "File saved as ";F$ 

JR 180 CLOSE ttl: POKE 710,148:P0KE 752, 0:E 

ND 
QG 110 DATA 89,0,89,0,112,8,4,98,4,173,31 

,208,41,4,248,10 
CZ 128 DATA 169,18,141,33,3,169,4,141,34, 

3,96,251,243,51,246,33 
OK 138 DATA 4,163,246,51,246,60,246,76,22 

8,243,8,238,33,4,172,33 
DB 148 DATA 4,192,39,288,18,169,0,141,33, 

3,169,228,141,34,3,185 
EC 158 DATA 59,4,168,1,96,67,65,82,155,88 

,79,75,46,56,57,44 
HU 168 DATA 80,69,69,75,40,53,54,49,41,58 

,82,85,46,34,68,58 
PZ 178 DATA 65,85,84,79,82,85,78,46,66,65 

,83,155,226,2,227,2 
VK 180 DATA 0,4,224,2,225,2,17,4 
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Ren XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 

Ren * * 

Ren * Survey Sweepstakes * 

Ren » * 

Ren * by A. Baggetta * 

Ren * Copyright 1989 * 

Ren * by ANALOG Computing * 

Ren * * 

Ren XXXXXXKXXXXXKXXXXXXXXXXKXXKXXXXKXXXXX 

Din 81dcolri(15),01dcolrr(15),01dcolrg(15),01dcolrbC15) 

Din Nane$C9),Nv(16),Chs$Cli:> 

Din 0.85 (100), 0.15(188), 105(100), 115(188), 125(188), 135(188), 145(188) 

Din 155(188), 165(188), I7S (188), 185 (188), 195(188) 

If Xbios(4)<>8 

Alert 3, "Low Rez Only", 1, "Sorry", DunnyX 
End 

Endif 

GColr_get 

Round=8 

Sr=99 

Turn=B 

Sound 1,8 

Wave 1,8 

Setcolor 4, 2,1, 4 

Setcolop 18,7, 7,7 

Setcolor 9, 7,7,7 

Print At(14, 2);"Select A File" 
„, GLod_file 

If Ed=l Then 
Goto Finish 

Endif 

Hiden 

Storage5="" 

Vour_naneS=" " 

5 Topgane: 

«* If Round=Sr Then 

PC GWinner_screen 

O If Ik5="V" Or Ik5="y" Then 

O Turn=6 

* IkS="" 

* Round=0 

Sr=99 
Goto Topgane 

Endif 

If Ik5="H" Or Ik5="n" Then 
Cls 

Goto Finish 
Endif 
Endif 
GOpening 
GPlace_question 
Leave=8 
Repeat 

If C_t_y=l Then 

GInput_your_answers 
Endif 

1 

' quit 

If IkS="V" Or Ik5="y" Then 

Turn=8 

IkS="" 

Round=8 

Sr=99 

Goto Topgane 
Endif 
If IkS="N" Or IkS="n" Then 

Cls 

Goto Finish 
Endif 

If C_t_n=l Then 

GInput_nornan_answer 

Endif 
Until Leawe=l 
If ReyS="V" Or RevS="y" Then 

Prbox 18,68,150,158 

Prbox 160,60,300,150 

Ancol=3 

Anrow=9 

For Blank=9 To 17 
Print At (3, Blank);" 

Next Blank 

Print At CAncol, Anrow) ;"Correct Answers" 

3D NOVEMBER A.IM.A.L.O.O. Computing 
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Anrow=Anrow+l 

For flni=6 To 4 

Print AtCAitcol, Anrow+CAni+1) ) ; ChsS CAni) 

Next Ani 

Print AttAncol, Anrow+ CAni+i) +2) ;"**Press Return**" 

Repeat 

Until InkeySO"" 
Endif 
Leave=0 
Goto End_round 

Face_data: 

Data 8, 0, 11, 8, 11, 8, 17, 3, 17, 3, 25, 11, 25, 11, 29, 23, 29, 23, 31, 28, 31, 28, 33, 19 
Data 33, 19, 36, 28, 36, 28, 37, 22, 37, 22, 36, 26, 36, 26, 34, 29 34 29 38 31 38 31 
Data 29, 39, 29, 39, 27, 47, 27, 47, 22, 52, 22, 52, 17, 54, 17, 54, 9, 55, 9, 55, 2 55 2, 55 

R ata ~l', 5 t- a ~hl 4 ^ n '^ 2 ' _11 ' 52 ' ~ 16 ' 47 ' ~ 16 ' 47 ' " 18 ' 39 ' " 18 - 39, L 19 31, -19 31 
Data -23, 29, -23, 29, -24, 26, -24, 26, -24, 22, -24, 22, -23, 28, -23, 28, -22, 19, -22, 19 

Data -28,28,-28,28,-18,23,-18,23,-14,18,-14,18,-6,3,-6,3,8,8 

1 brows 

Data -11, 22, -7, 28, -7, 28, -3, 28, -3, 28, 8, 28, 8, 28, 2, 22 

Data 9, 22, 11, 21, 11, 21, 14, 28, 14, 28, 18, 28, 18, 28, 22, 22 

1 glasses 

1 bridge 

' left view 

Data -18, 22, -IB, 24, -18, 24, 21, 25, 21, 25, 29, 22 

Data -18, 24, -12, 27, -12, 27, -12, 38, -12, 38, -11, 33, -11, 33, -9, 34, -9, 34, -5, 34 

Data -5,34,8,38,8,38,1,27,1,27,1,24 

' glasses 

' right view 

Data 18, 24, IB, 27, 18, 27, 11, 38, 11, 38, 16, 34, 16, 34, 28, 34, 28, 34, 22, 33, 22, 33 

Data 23,38,23,38,23,27,23,27,21,25 ' ' 

' nose 

Data 8, 38, 8, 33, B, 33, -1, 36, -1, 36, -3, 38, -3, 38, -4, 48, -4, 48, -1, 41, -1, 41 

Data 4, 42, 4, 42, 7, 42, 7, 42, 12, 41, 12, 41, 15, 48, 15, 48, 14, 38, 14, 38, 12, 36, 12, 36 

Data 11, 33, 11, 33, 11, 38 

1 stiile nouth 

Data -11, 48, -5, 45, -5, 45, 2, 47, 2, 47, 9, 47, 9, 47, 16, 45, 16, 45, 22, 48 

' tooth 

Data -2, 46, -2, 49, -2, 49, 2, 49, 2, 49, 2, 47 

Procedure Draw_faces 
Color 8 

Restore Face_data ■ 

Repeat >. 

Read C8K, R8y., ClJC, RV/. gp 

Line CZ+CBX/2, Rx+RBX/2, CX+ClX/2, RX+RiX/2 O 

Until CB«=2 And R8x=49 And C1X=2 And Rlx=47 Q 

Plot CX-7/2, Rx+28/2 ! Place Knowing Norman's eges SO 

Plot Cx-6/2, Rx+28/2 Jk 

Plot CX+17/2,Rx+28/2 * 

Plot CX+18/2, RX+28/2 
Deffill 9,2,8 
Fill CX+5, 32 
Deffill 3,2,8 

Fill CX-5/2, RX+29/2 2 

Fill CX+19/2, RX+29/2 © 

Deffill 12,2,8 w 

Fill CX+2/2, RX+27/2 
Deffill 8,2,8 
Fill CX+28/2, RX+25/2 

Return 

i 

■ 

Procedure Snile 
Graphnode 2 
Restore DtB 
RX=38 
CX=225 
Repeat 

Read C6X, R8X, CV/..RV/. 

Line CX+CBX/2, RX+R8X/2, CX+ClX/2, RX+RlK/2 
Until C8>!=2 And R8X=49 And Cl?:=:2 And RiK=47 
DtB: 

Data -11, 48, -5, 45, -5, 45, 2, 47, 2, 47, 9, 47, 9, 47, 16, 45, 16, 45, 22, 48 
' tooth 
Data -2, 46, -2, 49, -2, 49, 2, 49, 2, 49, 2, 47 

Return 

■ 

Procedure Sadness 
Restore Dtl 
RX=3B 
CX=225 
Repeat 

Read CBX, R8x, Clx, Rlz 

Line Cz+CBx/2, RY.+RQY./2, CZ+ClZ/2, RY.+R1Y./2 

NOVEMBER A.IM.A.L.O.Q. Computing 
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Until C0X=16 find R0X=45 find C1X=22 find RlX=47 
Dtl: 

Data -11, 47, -5, 45, -5, 45, 16, 45, 1G, 45, 22, 47 
Return 
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1 keep the old color pallett 

Procedure Colr_get 
For IX=0 To 15 

GVq_colortlX) 

01dcolriClX)=lX 

01dcolrr(lX)=RX 

01dcolrgCIX)=GX 

01dcolrbClX)=BX 
Next IK 

Return 

■ 

Procedure Uq_color (IX) 

Dpoke Contrl,26 

Dpoke Contrl+2, Q 

Dpoke Contrl+4, 

Dpoke Contrl+6, 2 

Dpoke Contrl+8, 

Dpoke Intin, IX 

Dpoke Intin+2, 1 

Vdisys 

RX=DpeekUntout+2) 

GX=Dpeek(Intout+4) 

Bx=Dpeek(Intout+6) 
Return 

' restore old colors and end 

Finish: 

For IX=0 To 15 

InX=01dcolridX) 

RX=01dcolrrCIX) 

GX=01dcolrgCIX) 

BX=01dcolrbClX) 

Gosub Ur_colorUnX, RX, GX, Bx) 
Next IX 
End 

Procedure Ur_color tlnX, RX, GX, Bx) 

Dpoke Contrl,14 

Dpoke Contrl+2, 

Dpoke Contrl+6, 4 

Dpoke Intin, InX 

Dpoke Intin+2, RX 

Dpoke Intin+4, GX 

Dpoke Intin+6,BX 

Udisys 
Return 

Procedure Opening 
Cls 

Reueal=0 
fing=0 
Mik=0 
If Turn=0 Then 

Vscr=0 

Nscr=0 

Deffill 4,2,19 

Color 4 

Box 0,0,310,199 

Box 40,25,270,170 

Fill 5,5 

Print AtC10,6);"Hi, I'm Nornan!" 

CX=150 

RX=30 

GDraw_f aces 

Deftext 4,4,0,6 

Text 77,168,"Surweg Sweepsteaks" 

Print AttlO, 10) J"Vour nane, please: "i 

Print AtC12, 13) J Vour_naneS 

Print AttlO, 13); 

Forn Input 20, New_naneS 

If New_naneS="" Then 
New_nane$=Vour_naMe$ 

Else 

Vour_naneS=New_nane$ 

Endif 

Print AttlO, 15) J"Reveal Answers? V/N" 

Leap: 
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Print AtC38, 15); 
Forn Input 1, Rev$ 

If Print < Att3B?15)?" > " U " *"" RevSO " N " And *™*<>"n M Then 

Goto Leap 
Endif 
Asr=5 
Bsr=18 

Sr=InttRnd*CBsr-Asr+l))+Asr 
Print AtUB, 17);" Rounds: " 

Print AtQ8, 18);" In This Gane ";Sr 
Pause 188 
Endif 
Used$="" 
Bonus=8 
Chancex=8 
Chance2x=B 
Ritechkx=8 
Ritechk2X=8 
ColX=2 
RowX=18 
CoInX=22 
RownX=18 
If Turn=8 Then 
Deffill 4,2,8 
Pbox 8,8,318,288 
Deftext 7,4,8,24 
Graphnode 2 

Text 19, 22, "Survey Sweepstakes" 
Deftext 6,4,8, 24 
Text 28, 23, "Survey Sweepstakes" 
Cx=225 
Rx=38 

GDraw_f aces 
Deftext 8,8,8, 4 
Text 28, 55, Vour_nane$ 
Text 178, 55, "Knowing" 
Text 245, 55, "Nornan" 
Deffill 1,2,8 
Color 18 

Rbox 159,59,381,151 
Prbox 168,68,388,158 
Color 11 

Rbox 9,59,151,151 
Prbox 18,68,158,158 
Deffill 8,2,8 
Deftext 1,8,8,4 
Color 8 

Rbox 9, 154, 3B1, 186 ! Outline question box in pink 
Prbox 18,155,388,185 ! Define a white window for questions 
Get 8, 8, 318, 199, Screen$ 
Deftext 8,8,8,4 

Text 165, 158, "Score :"+StrSCNscr) 
Text 15, 158, "Score:"+Str$ CYscr) 
Deftext 1,8,8,8 

Text 45, 172, ChrS C158) +"r ice "+ChrS C214) +"aterhose, "+ChrS C216) +"nc . ' 
Deftext 1, 1, 8, 4 

Text 65, 181, "Fictionalized Perlustrations" 
Deffill 8,2,8 
Pbox 188,35,198,45 
GIn_song 
Deftext 1,1,8,4 
Text 115, 42, "Press A Key" 
GMug_it 
Repeat 

Until InkeySO"" 
Else 

Put 8, 8, Screen?, 3 
Endif 
GConnent 
QMug_it 
Pause 188 
Deffill 1,2,8 
Prbox 168,68,380,158 
Turn=l 

Deffill 1,2,8 
Prbox 18,148,158,158 
Deftext 8,8, 8, 4 

Text 15, 158, "Score: "+Str$ tVscr) 
Prbox 168,148,388,158 
Text 165,158, "Score: "+StrSCHscr) 




Place Nornan Face 



Define two text windows in black 
Butline Neman's box 






! Outline your 



O 


90 
fa 

2 



M 

z 
o 

w 



Deftext 1,0, 8, 4 
Deffill 2,2,8 
Prbox 18,188,58,198 



Set up and identify the notice boxes 
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Graphnode 3 
Text 20,45, "BONUS" 
GBonus_sourtd 
For Rpt=l To 6 

Text 20, 45, "BONUS" 
Pause 10 
Next Rpt 
Bonus=l 

» Endif 

J* Graphnode 2 

Return 

•» Procedure Place-question 

Deffill 0,2,8 



Text 16, 195, "RIGHT" 

Deffill 3,2,8 

Prbox 78,188,110,198 

Text 76, 195,"WR0NG" 

Deffill 6,2,8 

Prbox 130,188,210,198 

Text 148,195, "ILLEGAL" 

Deffill 1,2,8 

Color 2 

Rbox 270,188,290,198 

Color 3 

Rbox 271,189,289,197 

Prbox 272,190,288,196 

Deftext 2,0,0, 4 

Text 225, 196, "Tiner->" 

Deftext 0,0,6,4 

Text 277,195," " 

Color 2 

Rbox 95,32,200,48 

Bn=Int(Rnd*5)+l ! If Bn=5 then we get a bonus round 

If Bn=5 Then ! Twenty points instead of ten 



Round=Round+l 

Pbox 108,35,190,45 
Z Deftext 1,16,0, 4 

q Text 125, 42, "ROUND "+Str$ CRound) 

Deftext 1,0,0, 4 

S Color 15 

O, Rbox 9,154,301,186 ! Outline question box in pink 

Prbox 10,155,300,185 ! Define a white window for questions 

GSelect-data 

Text 15,170, QuestOS 

Text 15, 177, QuestlS 

C_t_u=l 
jf Return 

Procedure Input_uour_answers 
C_t_n=8 
C_t_u=8 
id Leave=0 

* 

till 

Graphnode 2 
Response$="" 
Inc Chances', 
YclrX=7 
ColX=2 
LkX=0 

Print At(ColX-l, RowXJ;">" 
Print AtCColX+1, RowKJ;" 
Tnc=0 
Tn=ll 

Deftext 0,0,0, 4 
Deffill 1,2,8 
Repeat 
Inc Tnc 

If Tnc=1000 Then 
Sound 1, 15, 5, 7 
Dec Tn 
Tnc=0 

Prbox 272,190,288,196 
If Tn=10 Then 

Text 274, 195, StrSCTn) 
Else 

Text 277, 195, StrSCTn) 
Endif 

If Tn=0 Then 
Graphnode 3 
Sound 1, 
Setcolor 10,7,7,7 
Text 277, 195, StrSCTn) 
Pause 10 
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Tn=ll 
Tnc=0 

GBounce_out 
Graphnode 2 

I 

| If you cannot answer subtract 10 points fron your score and 
( give to nornan. Show capitalization on nornan window. 

Vscr=Vscr-18 

Deffill 1,2,8 

Prbox 10,148,150,150 

Deftext 8,0,0,4 

Text 15, 150,"Score: "+StrS(Vscr) 

Nscr=Nscr+10 

Prbox 160,140,300,150 

Deftext 8,0, 0,4 

Text 165, 150, "Score: "+StrS CNsciO +" CAPITALIZED" 

GCapital ize_sound 

Prbox 160,140,300,150 

Deftext 8,0,0,4 

Text 165, 150, "Score: "+StrS(Nscr) 

Graphnode 2 
C_t_n=i 

Endif 

If C_t_n=l Then 
Goto Byebye 

Endif 
Endif 
XS=InkeyS 
If LkX=16 Then 

Goto Out 
Endif 

Dec VclrX J 

Setcolor 10, VclrZ, Vc IrY., VclrX 
If Yclri^O Then 

VclrX=7 
Endif 

If I XS< c"l An<1 X$OChr$C8) Then ! IF fi LEGAL KEV IS PRESSED PRINT IT 

Print AtCColX, RowX);XS 

ResponseS=Response$+X$ 

Inc Lkx 
Endif , 

If F ^=^i" Then i IF THE BACKSPACE KEV IS PRESSED ERASE NAMES * 

ror trsX-o lo LolK Q 

Print AtfErsX, Rowz) ;" " a 

Next ErsK jg 

Coly.-2 t, 

Response$="" > 

Lkx=0 " 

Endif Z 

Sound 1,0 *} 

Outt 1 X$=ChrSC13J ! IF THE RETURN KEV IS PRESSED JUMP OUT £ 

Sound 1,0 © 

Graphnode 2 *• 

Rn=-1 272 ' 198 ' 288 ' 196 ! FILL IN TIMER WITH BLANK LJ 

Setcolor 10,7,7,7 

ResponseS=MidS(Response$, 1, Len (Responses) -1) 

If MidS(ResponseS, 1, 1)>"V And MidS (Responses, 1, 1)("{" Then 

ConwtS=MidS (Responses, 1, 1) 

Convt=Asc (ConvtS) 

Convt=Convt-32 

Mid$(ResponseS, 1, 1) =ChrS (Convt) 
Endif 

If MidS(ResponseS, l,4)="Quit" Or MidS(ResponseS, 1, 45 ="quit" Then 

l°Winner_screen 

Goto Byebye 
Endif 

If Mid$(ResponseS, l,5)="Chall" Or MidS (Responses, 1, 5)="chal 1" And Mik=0 Then 

nik=l 

Inc Rouy. 

C_t_n=l 

QChal l_nusic 

Goto Byebye 
Endif 

If MidS(ResponseS, 1, 5)="Chal 1" Or MidS (Responses, 1, 5) ="chall" And Mik=l Then 

Gil l_sign 

Goto Ul 
Endif 
If Mid$(ResponseS, 1, 4)=MidS (ChsS (0) , 1, 4) Then 

Rn=0 
Endif 
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5 
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O 
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If MidSCResponseS, 1, 4) =Mid$ CChsS CI) , 1, 43 Then 

Rn=l 
Endif 
If MidSCResponseS, 1, 4)=MidS£Chs$(2), 1, 4) Then 

Rn=2 
Endif 
If MidSCResponseS, 1, 4)=Mid$ tChs$C3), 1, 4) Then 

Rn=3 
Endif 
If MidSCResponseS, 1, 4)=Mid$CChsSC4), 1, 4) Then 

Rn=4 
Endif 
If Mid$CResponse$,l, 4)=Mid$tChs$C5),i, 4) Then 

Rn=5 
Endif 
If MidSCResponseS, 1, 4)=Mid$CChs$ t6), 1, 4) Then 

Rn=G 
Endif 
If Mid$CResponseS, 1, 4)=Mid$CChs$C7), 1, 4) Then 

Rn=7 
Endif 
If Mid$CResponse$, 1, 4)=MidS CChs$C8) , 1, 4) Then 

Rn=8 
Endif 
If MidSCResponseS, l,4)=MidsCChs$C9), 1,4) Then 

Rn=9 
Endif 
If Rn<8 Or Rn>9 Then 

Goto Junpover 

Endif 
■ 

1 It it has been used catch it and offer another chance 
■ 

GUsed_check 
If Cku=l Then 

Qlll.sign 

Dec ChanceX 

Goto Ul 

Endif 

UsedS=UsedS+StrSCRn) 

Cku=8 
■ 

Junpover: 
BCheck-answers 
If RightX=l Then 
GCorrect 
Inc RitechkX 
Inc RowX 
If Bonus=l Then 

Vscr=Vscr+2B 
Else 

Vscr=Vscr+18 
Endif 

Deffill 1,2,8 
Prbox 18,140,150,158 
Deftext 8,0,0,4 
For Rs=i To 5 

Graphnode 3 

Text 15, 150, "Score: "+Str$CVscr) 

Pause 10 
Next Rs 
Graphnode 2 
C_t_y=l 
Else 

Qlncorrect 

Inc Row* 

If Bonus=l Then 

Nscr=Nscr+2B 
Else 

Hscr=Hscr+18 
Endif 

Deffill 1,2,8 
Prbox 168,148, 388,158 
Deftext 8,8,8,4 
For Rs=l To 5 

Graphnode 3 

Text 165, 158, "Score: "+StrSCNscr) 

Pause 18 
Next Rs 
Graphnode 2 
C_t_n=l 
Endif 



If bonus round give an extra IB points 



Check to see if gour nunber of chances have been alloted or 
If you have three correct answers to win 
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If RitechkX=3 Then 

Leave=l 

Vscr=Vscp+20 

Deffill 1,2,8 

Prbox 10,148,156,150 

Deftext 8,0, 8,4 

For Rs=l To 5 
Graphnode 3 

Text 15, 158, "Score: "+Str$CVscr) 
Pause 18 

Next Rs 

Graphnode 2 

Goto Byebye 
Endif 
If ChanceX=4 Then 

Leave=l 
Endif 
Byebye: 
Graphnode 2 
Return 

Procedure Input_nornan_answer 

C_t_n=8 

C_t_y=8 

GMug_it 

Leave=8 

For Trpt=i To 4 
Graphnode 3 
Deftext 0,8,8,4 
Text 238, 149, "MV TURN!!" 
Pause 28 

Next Trpt I* 

Inc Chance2x P> 

Response$="" 

U2: 

Rn=B t 

ColnX=22 ? 

Rn=IntCRnd*15) 

If Rn>9 And Ang=8 Then 

Response$="Challenge " 

fing=i ! Allow only one challange EL 

ColnK=21 2 

Adx=8 ™ 

Print AtCColnX+i, Rownx);" " "9 

Fop Prtnn=l To Len (Responses) 5 

Inc fldx O 

Print At(ColnX+fidX,RownX)JMidsCResponseS,Prtnn,l) 2 

Pause IntCRnd*20)+l g 

Next Prtnn * 

Inc RounX * 

C_t_y=l £ 

GChall_nusic M 

Goto Byebye2 t 

Endif Z 

If Rn>9 And Ang=l Then a 

Goto U2 X 

Endif 

I ' ' 

1 Do not allow any repeats of the nunber 
i 

QUsed_check 

If Cku=l Then 

Goto U2 

Endif 

Used$=Used$+Str$CRn) 

Cku=0 
i 

Response$=Chs$(Rnl 
Pz=IntCRnd*12000J+l 
Tnc=0 
Tnrll 

Graphnode 2 
Deftext 0,0,0, 4 
Text 230, 149, "Hnnnnnnn?" 
For Pzrpt=l To Pz 
Tnc=Tnc+l 
If Tnc=100O Then 

Sound 1, 15, 5, 7 

Tn=Tn-l 

Tnc=0 

Prbox 272,190,288,196 

If Tn=18 Then 

Text 274, 195, StrStTn) 

Else 
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Text 277, 195, StrSCTn) 

End if 

If Tn=0 

Graphnode 3 

Text 236, 149, "Hnwwwi?" 

Graphnode 2 

Sound 1, 6 

For Rptnr=l To 3 

Graphnode 3 

Text 277,195, StrSCTn) 

Pause 10 

Next Rptnr 

Graphnode 2 

Tn=10 

Tnc=0 

GBounce_out 

C_t_u=l 

If C_t_u=l Then 

Goto Ot 

Endif 

Endif 

Endif 

Ot: 

Sound 1,0 

Exit If C_t_u=l 

Next Pzrpt 

If C_t_9=i Then 

Goto Byebye2 

Endif 

Graphnode 3 

Text 230, 149, "Hnnnnnnn?" 

Sound 1,6 

ColnX=21 

Adx=0 

Fka=65 

Fkb=122 

Print At(Colnx+l, RounX) J" " 

Stln=Len (Response*) 

For Prtnn=l To Stln 

Inc AdX 

Print At CColnX+AdX, RounX) ;MidS CResponseS, Prtnn, 15 

Pause IntCRnd*40)+l 

Fk=Int(Rnd*CFkb-Fka+l))+Fka ! Nornan nakes typing errors and 

Fkk=IntCRnd*5)+l ! corrects then. 

If Fkk=5 And StlnOPrtnn Then 

Print AtCColnX+Adx+1, RownX) ;ChrSCFk) 

Pause IntCRnd*40)+l 

Endif 

Next Prtnn 

Pause 80 
■ 

OCheck_ansuers 
If RightX=l Then 
GCorrect 
Inc Ritechk2x 
Inc Rown/. 
If Bonus=l Then 

Hscr=Nscr+20 
Else 

Nscr=Hscr+10 
Endif 

Deffill 1,2,8 
Prbox 160,140,300,158 
Deftext 8,0, 0,4 
For Rs=l To 5 

Graphnode 3 

Text 165, 150, "Score: "+StrS CNscrJ 

Pause 10 
Hext Rs 
Graphnode 2 
C_t_n=l 
Else 

GIncorrect 

Inc RounX 

If Bonus=l Then 

Vscr=Vscr+20 
Else 

Vscr=Vscr+10 
Endif 

Deffill 1,2,8 
Prbox 10,140,150,150 
Deftext 8, 0, 0, 4 
For Rs=l To 5 

Graphnode 3 

Text 15, 150,"Score: "+StrS CVscrJ 



SB 
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Pause 10 
Next Rs 
Graphnode 2 
C_t_u=l 
Endif 

If Chance2x=>4 Then 
Leave=l 
Goto Byebye2 
Endif 

If Ritechk2x=3 Then 
Leave=l 
Deffill 1,2,8 
Prbox 168,148,388,158 
Deftext 8,8, 8,4 
For Rs=i To 5 
Graphnode 3 

Text 165, 158, "Score: "+Str$ CNscr) 
Pause 18 
Next Rs 
Graphnode 2 
Endif 
Byebye2: 
Graphnode 2 

Return 

■ 

Procedure Correct 
Sound 1, 8 
Graphnode 2 
Deftext 1,8,8,4 
Deffill 2,2,8 
For Jx=l To 5 

Sound 1,18,9,5,2 

Prbox 18,188,58,198 

Pause 5 

Text 16, 195, "RIGHT" 

Sound 1,18,4, 5,15 
Next Jx 
Sound 1, 8 
RightX=0 

Return 

■ 

Procedure Incorrect 
Sound 1,8 
Have 1,8 
Graphnode 2 
Deftext 1,8,8,4 
Deffill 3,2,8 
Wave 1,1,14,35 
For Jx=l To 5 

Prbox 78,188,118,198 

Pause 5 

Text 76, 195, "WRONG" 

Pause 5 
Next Jx 
Wave 1,8 
Return 

Procedure Check-answers 

Rightx=8 

Wrongx=B 

For Ix=8 To 4 

If MidSCChs$tlX),l, 4)=Mid$ [Response*, 1, 4) Then 

RightX=l 

Endif 

Next IX 

Return 
■ 

End_round: 

Sound 1,8 

Wave 1,8 

Cls 

Deffill 1,2,8 

Prbox 8,48,320,178 

Deftext 2,4, 8,24 

Text 50, 10O, "End of Round "+StrS CRound) 

Deftext 3,4, 0, 6 

If Vscr>Nscr Then 

Text 75, 128, "The winner so far is " 

Text 80, 135, Your_nane$ 

Text 80, 150, StrSCYscr)+" points" 
Endif 
If Nscr>Yscr Then 

Text 40, 120, "Seens like Nornan is winning." 

Text 40, 135, Str$ CNscr) +" points" 
Endif 



J 



If Nscr=Vscr Then 

Text 48, 128, "Well, we have a tie so far." 

Text 48, 135, StrS(Nscr) +" to "+Str$CYscrI 
Endif 

Wave 1,1,12,388 
ScrnX=7 
Fop Srptrl To 28888 

Dec Scrnx 

If ScrnX=8 Then 
ScrnX=7 

Endif 

Setcolor 8, ScrnX, Scrnx, ScrnX 
Next Srpt 
Setcolor 8,7,7,7 
Wave 1, 8 
Bonus=8 
Goto Topgane 

Procedure Ill_sign 
Sound 1, 8 
Wave 1, 8 
Graphnode 2 
Deftext 1,8, 8, 4 
Wave 1,1,8,188 
For RptX=l To 5 

Deffill 6,2,8 

Prbox 138,188,218,198 

Pause 18 

Text 148, 195, "ILLEGAL" 

Pause 18 

Next RptX 

Wave 1,8 

Graphnode 1 

Return 
■ 

Procedure Select-data 
SsX=IntCRnd*CUbls-l)) 
Ss$=Str$(SsX) 
If LenCSs$)<2 Then 

Ss$="8"+Ss$ 
Endif 

Add_data=Add_data+l 
If Add_data=Ubls-l Then 

Storage$="" 

Add_data=B 
Endif 
For ExX=8 To Len CStorageS) 

If MidSCStorageS, ExX, 2)=SsS Then 
QSelect_data 

Endif 
Next ExX 

Storage$=Storage$+Ss$ 
Quest8$=Q8$CSsX) 
Questl$=Qi$CSsX) 
Chs$CB)=I8$CSsX) 
Chs$Ci)=Il$tSsX) 
ChsSC2)=I2SCSsX) 
Chs$C3)=I3$CSsX) 
Chs$C4)=I4SCSsX) 
ChsSC5)=I5$CSsX) 
Chs$C6)=I6$CSsX) 
Chs$C7)=I7$CSsX) 
Chs$C8)=I8$(SsX) 
Chs$C9)=I9SCSsX) 

Return 

■ 

Procedure Lod-file 
Ed=8 
Fi 1 esel ec t "a : \* . swp", "Quest3 . swp", AaS 

If ExistlAaS) Then 
flpen "I",ttl,Aa$ 
Input ttl, A$ 
Vbls=v"alCA$) 
Print AtC18,lB)JAa$ 

Print AtClB, 12);"Loading ";VblsJ" Questions" 

Print AtClB, 14) ; "Question tt"J 
For lx=8 To Ubls-1 

Print At(21, 14) ; Ix+1 

Input ttl, AS 

Q0SCIx)=A$ 

Input ttl, AS 

Q1SUX)=A$ 

Input ttl, AS 

I0SCIX)=A$ 
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Input 81, AS 
USCIX)=AS 
Input 81, AS 
I2SCIX)=AS 
Input 81, AS 
I3StIX)=AS 
Input 81, AS 
I4$tlX)=AS 
Input 81, AS 
XI » I5SUXJ=A$ 

Input 81, AS 
I6$CIX)=AS 
3 Input 81, AS 

I7SCIXJ=AS 
"* Input 81, AS 

V I8SCIXJ=A$ 

* *>> Input 81, AS 

I9SCIXJ=AS 
Hext IX 
Pause 166 



■ 4 V 



Else 

Alert 3," | IMissing Question File", 1, "EHD", Ab 

Ed=l 
Endif 
Cls 
Return 

Procedure Used_check 

Cku=6 

For Ex2X=l To LenCUsedS) 

If MidSCUsedS, Ex2x, D=StrSCRn) Then 

Cku=l 

Endif 

Hext Ex2X 

Return 
■ 

Procedure Bounce_out 
Sound 1, 6 
Wave 1,6 
For Drop=12 Downto 1 

Sound 1, 16, Drop, 4,1 
Next Drop 
Sound 1,6 

For Bounce=l To 10 
For Up=l To 3 

Sound 1,10, Up, 4,1 
Next Up 
For Down=3 Downto 1 

Sound 1, 16, Down, 4, 1 
Next Down 
Next Bounce 
Sound 1,10,1,1,10 
Sound 1,0 
Wave 1,0 
Return 

Procedure Minner_screen 
Graphnode 2 
Cls 

Sound 1, 
Have 1,0 
Deffill 1,2,8 
Prbox 0,40,328,176 
Deftext 2,4,0,24 
Text 100, 100, "WINNER" 
Deftext 3, 0,0,6 
If Nscr>Vscr Then 

Tval=Nscr*IntCRnd*268)+l 

TvalS=Str$CTval) 

Text 78, ^B/'Nornan" 

Text 76, 135, "S"+TvalS+" "+StrS CNscr) +" points" 

Nscr=6 

Tval=8 

Goto Cloz_up 
Endif 
If Vscr>Nscr Then 

Tval=Yscr*Int CRnd*268) +1 

TvalS=StrSCTval) 

Text 78, 126, Vour_naneS 

Text 76, 135, "S"+TvalS+" "+StrS tVscr)+" points' 

Vscr=6 

Tval=8 

Goto Cloz-up 
Endif 
If Vscr<>0 And Nscr<>8 And Vscr=Nscr Then 
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Text 55, 128, "Tie Gane...No winners here." 
Endif 
Cloz_up: 
Wave 1,1,12,300 
ScrnX=7 

Text 35, 150, "<V> to play again <N> to end" 
Repeat 

Dec ScrnX 

If ScrnX=0 Then 
ScrnX=7 

Endif 

Setcolor 0, ScrnX, ScrnX+2, ScrnX+4 

Ik$=Inkey$ 

Pause 5 
Until Ik$="V" Or IkS="y" Or Ik$="N" Or Ik$="n" 
Setcolor 0,7,7,7 
Wave 1, 
Return 

Procedure Chall.nusic 
Sound 1, 
Sound 2,0 
Sound 3, 
Wave 7,0 
Restore C_najor 
Fop G=l To 5 

Read Ntl, Ht2, Nt3, Oct 

Sound 1, 10, Ntl, 5 

Sound 2, 10, Nt2,5 

Sound 3, 18, Nt3, 5 

Wave 7,7,3,15000,10 

Next G 

C_najor s 

Data 1,5,8,4 

C_tiinor! 

Data 1,8, 4,4 

C_najor_6! 

Data 1,5, 10,3 

C_ninor_7: 

Data 4,1,10,3 

C_7: 

Data 1,5,11,4 

Return 
■ 

Procedure In_song 
Restore Intro_song 
For Sn=l To 9 

Del=5 

If Sn=3 Or Sn=6 Or Sn=9 Then 
Del=9 

Endif 

Read Xs 

Sound 1, 10, Xs, 4, Del 
Next Sn 

Sound 1,10,12,3 
Sound 2,10,3,4 
Sound 3,10, 8,4 
Wave 7,7,3,8008,10 
Intro-songs 
Data 12,10, 8 
Data 10, 8,6 
Data 8, 6, 5 
Return 



Procedure 

Cont=In 

If Cont 

Print 

Print 

Endif 

If Cont 

Print 

Print 

Endif 

If Cont 

Print 

Print 

Endif 

If Cont: 

Print 

Print 

Endif 

If Cont: 

Print 

Print 



Connent 
t(Rnd*10)+l 
:1 Then 

AtC22, 12);" Ok, Pal... 

AtC22, 13);"Let's 300000!! 

:2 Then 

AtC22, 12);" Ok pushover 
AtC22, 13);"Get cookin!!!! 



:3 Then 

At (22, 12) ;"Make out your 
AtC22,13);"will yet??? 

:4 Then 

AtC22, 12);"Might as well 

AtC22,13);"quit right now! 

5 Then 

AtC22, 12);"Look out, kid.. 

AtC22,13) ;"dis is war! ! ! 



Endif 

If Cont: 
Print 
Print 

Endif 

If Cont: 
Print 
Print 

Endif 

If Cont: 
Print 
Print 

Endif 

If Cont: 
Print 
Print 

Endif 

If Cont= 
Print 
Print 

Endif 
Return 



:6 Then 

AtI22, 12);"Scared, yet, 
AtC22, 13);"Pal??? 

:7 Then 

AtC22, 12);"Get your coffin 
At (22,13); "ready! ! 

8 Then 

Att22, 12);"Vour feelin' da 
At £22, 13); "heat now...?? 

9 Then 

At(22, 12) ;"Psssssssst! 

At C22, 13) ; "Booooooooooo! . . 



10 Then 

AtC22, 12);"Go back to grade" 

AtC22, 13);"school! ! ! 



Procedure Mug_it 
Graphnode 2 
For Facerpt=l To 3 

Sound 1,10,12,6,1 

Color 

GSnile 

Color 8 

QSadness 

Pause 2 

Sound 1,10,1,6,1 

Color 

GSadness 

Color 8 

GSnile 

Pause 2 

Next Facerpt 

Sound 1, 

Return 
■ 

Procedure Bonus_sound 

For Decay=15 To Step -3 

For Ups=l To 12 

Sound 1, Decay, Ups, 5,1 

Next Ups 

Next Decay 

Return 
1 

Procedure Capital ize.sound 
For Cap=l To 100 
For 1=1 To 10 

Wave 1,1,1800, I 
Next I 
For 1=18 To 1 Step -1 

Wave 1,1,1000, I 
Next I 
Next Cap 
Sound 1, 
Wave 1,0 
Return 
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NOVEMBER A.IM.A.L.O.Q. Computing 



FEATURE 




2278 DATA 5,32,71,36,162,3,142,91,42,9 

6,160,255,208,177,243,72,1279 

2288 DATA 41,127,32,193,32,184,16,244, 

96,32,16,48,168,3,185,128,5876 

2298 DATA 5,281,155,208,88,96,169,18,1 

41,254,6,133,285,133,207,169,2088 

2388 DATA 8,141,255,6,133,288,133,286, 

96,32,16,48,32,14,38,160,3445 

2318 DATA 1,177,283,16,1,96,133,1,136, 

177,283,133,0,32,92,41,4165 

2328 DATA 168,1,177,283,16,240,165,0,2 

4,101,207,141,254,6,133,205,356 

2330 DATA 165,1,105,0,141,255,6,133,20 

6,96,216,173,254,6,56,229,1309 

2340 DATA 207,141,254,6,173,255,6,229, 

208,141,255,6,96,162,0,185,519 

2350 DATA 128,5,201,44,240,16,201,155, 

240, 12, 157, 210, 42, 232, 224, 6, 987 

2368 DATA 248,84,280,76,105,48,157,210 

,42,140,79,42,169,0,133,242,8431 

2378 DATA 133,285,32,199,48,32,8,216,3 

2, 218, 217, 176, 57, 165, 213, 48, 9826 

2388 DATA 53,141,255,6,133,286,165,212 

,141,254,6,133,285,172,79,42,657 

2398 DATA 185,128,5,281,155,208,1,96,1 

62,8,200,185,128,5,201,155,9555 

2488 DATA 248,39,157,218,42,232,224,6, 

248,12,76,188,48,169,218,133,687 

2418 DATA 243,169,42,133,244,96,104,10 

4,162,11,189,139,42,32,193,32,6721 

2428 DATA 282,16,247,32,81,218,76,134, 

33, 157, 218, 42, 169, 8, 133, 242, 9585 

2438 DATA 32,199,48,32,8,216,32,210,21 

7,176,219,165,212,133,207,165,4773 

2440 DATA 213,133,208,48,289,32,81,218 

,96,32,35,48,169,0,141,64,4668 

2458 DATA 42,32,14,38,168,8,177,283,13 

3, 226, 208, 177, 283, 133, 227, 48, 2868 

2468 DATA 27,285,255,6,240,8,176,28,32 

,92,41,76,14,41,165,226,5744 

2478 DATA 285,254,6,248,4,176,5,144,23 

9, 76, 134, 33, 32, 84, 40, 169, 6181 

2480 DATA 7,160,132,162,41,32,92,228,3 

2,81,218,169,10,141,134,42,7026 

2498 DATA 169,8,133,194,141,136,42,169 

,1,141,135,42,141,64,42,76,4984 

2500 DATA 134,33,132,230,160,2,177,203 

,216,24,181,203,133,203,165,204,3732 

2510 DATA 105,0,133,204,164,230,96,32, 

92,41,132,230,160,0,177,203,391 

2520 DATA 133,226,200,177,203,133,227, 

164,230,96,173,135,42,240,99,165,3711 

2530 DATA 194,240,95,173,134,42,240,6, 

206,134,42,76,236,41,169,0,7576 

2540 DATA 141,135,42,173,254,6,24,101, 

207,141,254,6,133,212,173,255,3562 

2550 DATA 6,101,208,141,255,6,133,213, 

165,213,48,26,197,227,240,8,1814 

2568 DATA 144,31,32,113,41,76,178,41,1 

65,212,197,226,240,8,144,17,9697 

2578 DATA 32,113,41,76,178,41,238,82,4 

2,169,12,141,252,2,76,236,8825 

2588 DATA 41,32,178,217,32,238,216,32, 

244,39,169,32,32,193,32,32,6310 

2590 DATA 81,218,76,98,228,32,35,32,82 

,79,82,82,69,155,181,183,5284 

2600 DATA 97,107,99,97,80,32,115,181,1 

05,116,105,108,105,116,85,32,5133 

2618 DATA 67,73,83,65,66,125,112,112,6 

6,24,42,1,0,0,0,0,7400 

2620 DATA 0,0,0,0,0,0,0,37,56,37,35,53 

,52,41,41,46,7412 

2630 DATA 39,0,44,41,46,37,26,0,0,0,0, 

0,0,0,0,0,3599 

2640 DATA 0,0,0,0,0,0,0,83,42,88,42,18 

,11,12,13,35,6210 

2650 DATA 4,95,42,133,42,155,100,101,1 

14,101,98,109,117,110,101,114,6972 

2660 DATA 32,109,97,114,103,111,114,80 

,155,56,54,55,50,51,32,61,2305 

2670 DATA 62,32,101,110,105,76,155,89, 

68,65,69,82,139,42,166,42,4879 

2688 DATA 155,114,111,114,114,101,32,1 

01,117,108,97,86,48,49,58,51,3168 

2690 DATA 52,53,54,55,56,57,65,66,67,6 
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NOVEMBER A.N.A.L.O.Q. Computing 



1D3 



_8_ 



FEATURE 



© 

2 

v> 

>i 

at 
O 

O 
oe 
a 



«. 



8,69,70,204,42,209,42, 


1764 


0900 




LDA 


B <SYSRST 


2700 DATA 68,58,42,46, 


*2, 155, 247, 42, 24 


0910 




STA 


DOSINI 


7,42,0 


,226,2,227,2,0,4988 


0920 


1 






2710 DATA 32,0,0,0,0,0 


,0,0, 0,0,0,0,0,0 


0930 


;reset character counter 


,0,0,2742 




0940 


i 






Listing 2: 

Assembly 




0950 
0960 
0970 




LDA 
STA 
STA 


«0 

CHRCNT 

QTFLAG 


0100 


;SAUE8D:BUPP1.M65 


0980 




STA 


TFLG ; trace flag 


0110 






0990 
1000 


t 
Jfi 


nd ed 




0120 




i 


itor vectors 


0130 


BUP.5Y5 part I 


i 


1010 


j search 


handler for E: 


0140 




t 


1020 


. 






0150 


CO 1989 


t 


1030 




LDY 


SO 


0160 


; by Barry Kolbe 


i 


1040 


El 


LDA 


HATBAS, Y 


0170 
0180 




i 


1050 
1060 




CMP 
BEQ 


tt'E 




i 


E2 ;got.it 


0190 


.OPT NO LIST 




1070 




INY 




0200 






1080 




INY 




0210 


; equates 




1090 




INY 




0220 






1100 




CPY 


833 


0230 


.0 - 500 




1110 




BNE 


El 


0240 


JO = 502 




1120 




RTS 




0250 


EOL = 59B j 


end of line 


1130 


. 






0260 


LINENO = SE8 , 


line nuwber 


1140 


E2 


INY 


; point to 


0270 


LINPTR = SCB 


ptr to line 8 


1150 




LDA 


« <MYEDIT ;my patch 


0280 


CLINE = $CD 


current line 


1160 




STA 


HATBAS, Y 


0290 


ILINE = $CF 


increnent line 


1170 




INY 




0300 


FLINE = S06FE 


first line 


1180 




LDA 


tt >MYEDIT 


0310 


RLIME = SE2 


referenced line 


1190 




STA 


HATBAS, Y 


0320 


5PTR = $E4 


ptr. for seach 


1200 




LDY 


tto ;copy systen 


0330 


SLIME = $E6 


search line 


1210 


E3 


LDA 


$E400,Y ;routines 


0340 


UNTP = 582 


var. nane table 


1220 




STA 


MYEDIT,Y ;to My 


0350 


STMTAB = 588 


; BASIC statHt. 


1230 




INY 


; patch 


0360 


PROMPT = SC2 


Iflag-BAIC done? 


1240 




CPY 


»16 


0370 


CRITIC = 542 


cirtical i/o 


1250 




BNE 


E3 


0380 


ICCOM = $0342 


; command 


1260 


. 






0390 


ICBAL = $0344 


jbuff. address 


1270 


;get byte vector 


0400 


ICBAH = $0345 




1280 


. 






0410 


ICBLL = $0348 


jbuff. length 


1290 


' 


LDA 


tt <GETC0M-1 ;point it 


0420 


ICBLH = $0349 




1300 




STA 


MYEDIT+4 ;to My 


0430 


ICAUK1 = $034A 


;aux. byte 


1310 




LDA 


tt >GETC0M-1 ; wedge 


0440 


HATBAS = $031A 


jhandler table 


1320 




STA 


MYEDIT+5 


0450 


LBUF = $0580 


; input buffer 


1330 




CLC 


;put systeM 


0460 


MEMLO = $02E7 


; Memo 


1340 




LDA 


$E404 ;get byte 


0470 


D05IHI = $0C 


;disk init. 


1350 




ADC 


ttl ;at beginning 


0480 


DLISTL = $0230 


;display list 


1360 




STA 


GETCOM+1 


0490 


DLI5TH = $0231 




1370 




LDA 


$E405 


0500 


CIO = $E456 


;cio vector 


1380 




ADC 


ttO 


0510 


FASC = SD8E6 


; f p to ascii 


1390 




STA 


GETCOM+2 


0520 


AFP = $D800 


;ascii to fp 


1400 


. 






0530 


IFP = $D9AA 


; integer to fp 


1410 


;put byte vector 


0540 


FPI = $D9D2 


j f p to integer 


1420 


. 






0550 


FRO = $D4 


jfp register 


1430 




LDA 


$E406 ;get vector 


0560 


FR1 = $D5 




1440 




CLC 


; vectors are 


0570 


SETLBF = $DA51 


;reset lbuf 


1450 




ADC 


ttl ;always -1 


0580 


5ETVBU = $E45C 


;set vert, blnk 


1460 




STA 


puti+i ;add 1 


0590 


5YSUBU = $E45F 


jsystew ubi 


1470 




LDA 


$E407 ; install in 


0600 


XITVBU = $E462 


jexit Ubi 


1480 




ADC 


ttO jMy 'PUTC 


0610 


INBUF = $F3 


; input buf. ptr 


1490 




STA 


PUTi+2 ;routine 


0620 


CIX = $F2 


;char. index 


1500 




LDA 


tt >ENDPRG ;set LOMEM 


0630 


WARMST = $E474 


; warnstart 


1510 




STA 


MEMLO+1 


0640 


UUBLKD = $0224 


jdeferred reg 


1520 




LDA 


tt <ENDPRG 


0650 


DOSUEC = $0A 




1530 




STA 


MEMLO 


0660 


i 




1540 


■ 






0670 


*= $2000 




1550 




LDA 


tt$9G ;chang color 


0680 


1 




1560 




STA 


710 


0690 


INI CLD 




1570 




LDX 


828 ;say we are 


O70O 


LDA DLISTL 


;save orig 


1580 


Bl 


LDA 


BB1,X ;here! 


0710 


STA DLS 


;display list 


1590 




JSR 


PUTC 


0720 


LDA DLISTH 


;pointer 


1600 




JSR 


WAIT ;wait a jiff 


0730 


STA DLH 




1610 




JSR 


WAIT ; Maybe two 


0740 


LDA DOSINI 


; save 


1620 




DEX 




0750 


STA SYSRST+1 


;D0SINI 


1630 




BPL 


Bl 


0760 


LDA DOSINI+l 




1640 




LDX 


tt$FF ;clear stack 


0770 


STA SYSRST+2 




1650 




TXS 




0780 


1 




1666 




J MP 


$AOO0 ;jump to BASIC 


0790 


; save inned .ubi 


vectors 


1670 


■ 






0800 


j 




1680 


WAIT 


0810 


LDA UUBLKD 




1690 




STA 


20 


0820 


STA UBLKDS 




170O 


MIT 


LDA 


20 


0830 


LDA UVBLKD+i 




1710 




BEQ 


WIT 


0840 


STA UBLKDS+1 




1720 




RTS 




0850 


i 




1730 


■ 






0860 


;reset My SYSTEM 


RESET routine 


1740 


; handle 


SYSTEM RESET button 


0870 


f 




1750 


. 






0880 


IN2 LDA 8 >SYSRS 


T 


1760 


SYSR5T 


JSR $FFFF ;does DOSINI 


0890 


STA DOSINI+l 




1770 




JMP 


IN2 ;reset 



1D4 



NOVEMBER A.N.A.L.O.Q. Computing 



FEATURE 



1780 



1798 


; print 


Accunulator via put byte 


1800 


t 






1810 


PUTC 5TK XSAU 


;saue X, Y 


1820 


5TY 


PYSAV 




1830 


PUT1 JSP. SFFFF 


;put byte 


1840 


LDX 


XSAU 


;restore X,Y 


1850 


LDY 


PYSAU 




1860 


RT5 






1870 


i 






1880 


;get bytes fron 


editor 


1890 


i 






1900 


GETCOM 


J5R SFFFF ; 


1910 


PHP 




;save status 


1920 


CPY 


ttSse 


; break key 


1930 


BEO 


BRK 


J yes 


1940 


CMP 


»EOL 


; RETURN? 


1950 


BEQ 


G0TRT1 


;yup 


I960 


STX 


X3 


;save X 


1970 


LDX 


LSTKEY 


; last key 


1980 


CPX 


ttSFF 


;ret? = ff 


1990 


BNE 


KOK 




2000 


LDX 


tto 


; reset countr 


2010 


STX 


CHRCNT 




2020 


STX 


LSTKEY 




2030 


<0K LDX 


X3 


;ge<- X 


2040 


INC 


CHRCNT 




2050 


J MP 


NOBRK 


;skip over 


2060 








2C78 BRK LDA 


txo 


;on break turn 


2080 


STA 


ONOFF 


;everything 


2090 


STA 


QTFLAG 


;OFF! 


2100 


STA 


CHRCNT 




2110 


STA 


ENDLIN 




2120 


LDA 


»7 


;restore vectors 


2130 


LDY 


VBLKDS 


; for UBI 


2140 


LDX 


UBLKDS+1 




2150 


JSP. 


SETYBU 




2160 


JSP. 


SETLBF 


;floating point 


2170 


J MP 


EXIT2 


;pointers 


2180 








2190 NOBRK PLP 


;restore status 


2200 


RTS 




; done 


2210 








2220 


BASIC dor 


line 


2230 








2240 


PROMPT 


<> O when BASIC 


2250 


is done parsing 


a line 


2260 


endlin 


=0 neans 


line 


2270 


not completely 


entered 


2280 


fron BASIC 




2290 








2300 ( 


J0TRT1 LDA TFLAG 


2310 


BNE 


BRK 




2320 


LDA 


ONOFF 


;autonun? 


2330 


BEQ 


NOTON 


;0= off 


2340 


LDA 


05 


;UBI tiner 


2350 


STA 


TIMER 




2360 


LDA 


ttl 




2370 


STA 


ENDLIN 




2380 


LDA 


tto 




2390 


STA 


PROMPT 


jclear for 


2400 


STA 


CHRCNT 


; BASIC 


2410 


LDA 


ttEOL 




2420 


PLP 






2430 


RTS 






2440 








2450 


autonuM not on 




2460 








2470 1 


IOTON STY Yl 


jsaue regs 


2480 


STX 


XI 




2490 


LDX 


«$FF 


jlast key 


2500 


STX 


LSTKEY 




2510 j 








2520 , 


check connand 




2530 , 








2540 


LDY 


tto 




2550 


STY 


CY1 




2560 C 


TCM1 LDY CY1 




2570 


LDX 


tto 




2580 


LDA 


LBUF,X 


; first char 


2590 


CMP 


COMTAB, Y 


;in table? 


260B 


BNE 


NOMAT 




2610 


INY 






2620 


INX 






2630 


LDA 


LBUF,X 


;try second 


2640 


CMP 


COMTAB,Y 


; char 


2650 


BNE 


NOMAT 




2660 


INY 






2670 


INX 






2680 


LDA 


LBUF,X 


;try third 


2690 


CMP 


COMTAB, Y 




2700 


BNE 


NOMAT 




2710 ; 








2720 ; 


got natch 




2730 ; 








2740 


INY 






2750 


LDA 


COMTAB,Y 




2760 


STA 


TAKEOF+1 


j find addr 


2770 


INY 




; of ny 



2780 
2790 
2800 
2810 
2820 
2830 
2840 
2850 
2860 
2870 
2B80 
2890 
2900 
2910 
2920 
2930 
2940 
2950 
2960 
2970 
2980 
2990 
3000 
3610 
3820 
3830 
3640 
3850 
3060 
3870 
3880 
3890 
3100 
3110 
3120 
3130 
3140 
3150 
3160 
3170 
3180 
3190 
3200 
3210 
3220 
3230 
3240 
3250 
3260 
3270 
3280 
3290 
3300 
3310 
3320 
3330 
3340 
3350 
3360 
3370 
3380 
3390 
3400 
3410 
3420 
3430 
3440 
3450 
3460 
3470 
3480 

3490 
3500 
3510 
3520 
3530 
3540 
3550 
3560 
3570 
3580 
3590 
3600 
3610 
3620 
3630 
3640 
3650 
3660 
3670 
3680 
3690 
3788 
3718 
3720 
3730 
3740 
3750 
3760 
3770 



LDA C0MTAB,Y ;routine 

STA TAKEOF+2 

LDY CHRCNT ;stick in 



LDA ttEOL 

STA LBUF,Y 

CLD 

JSR CRUNCH 



;a RETURN 



;snash spaces 



TAKEOF JMP SFFFF ; go to it 



;exit routines 

EXIT2 LDY »0 
STY SC3 
STY CHRCNT 
LDA »' . 
STA LBUF,Y 
INY 

LDA ttEOL 
STA LBUF,Y 

EXIT1 LDX XI 
LDY Yl 
LDA ttEOL 
PLP 
RTS 

i 

;no natch 

NOMAT LDA CY1 
CLC 

ADC tt5 

STA CY1 

CMP ttS41 

BNE GTCM1 

LDY CHRCNT 

LDA ttEOL 

STA LBUF,Y 

BNE EXIT1 



;show BASIC 
;no error 

;REM 



;and EOL 

; restore X,Y 
jnake a 
;nornal exit 



;try next 
; connand 



; 13 connands 
;G 5 bytes 
jeach 

;put in RETURN 
;and exit 



;crunch out spaces in input 



CRUNCH 

CR1 LDA 
CMP 
BEQ 
INX 
BPL 

GOTEND 
LDX 

SQUISH 
CMP 
BEQ 
CMP 
BNE 

D05QSH 
TAY 

SQ5HLP 
STA 
INY 
CPY 
BNE 
DEC 
JMP 

N0SQ5H 
CPX 
BNE 

CR2 RTS 



LDX ttO 
LBUF,X 
ttEOL 
GOTEND 

CR1 
STX ENDP 

80 
LDA LBUF 

ttEOL 

CR2 

it$20 

NOSQSH 
TXA 

LDA LBUF 
LBUF,Y 

ENDPTR 
SQSHLP 
ENDPTR 
SQUISH 
INX 
ENDPTR 
SQUISH 



;find the 
; length 

; found it 



TR ;save end 
;now collapse 

,X Jit and 
;renoue spaces 

; space? 
;no squish 

;copy fron 
+1,Y ;back 
;to front 
;next one 
;done yet? 
; no 

; len=len-l 
; nore 
;done yet 

; no 

; finished 



iconnand table 



COMTAB .BYTE "DIR 1 
.WORD DIR 



BYTE 


"ERA" 


WORD 


ERA 


BYTE 


"PRO" 


WORD 


LOCK 


BYTE 


"UNP" 


WORD 


UNLOCK 


BYTE 


"NAM" 


WORD 


RENAM 


BYTE 


"DOS" 


WORD 


DOS 


BYTE 


"TRA" 


WORD 


TRACE 


BYTE 


"OFF" 


WORD 


TOFF 


BYTE 


"NUM" 


WORD 


AUTNUM 


BYTE 


"REN" 


WORD 


RENUM 


BYTE 


"DEC" 


WORD 


DECHEX 


BYTE 


"HEX" 


WORD 


HEXDEC 


BYTE 


"LUA" 


WORD 


UARLST 



;directory routine 



DIR JSR TURNOF 
JSR CL0SE5 



jtrace off 
;close iocb 5 



3780 
3790 
3800 
3810 
3820 
3830 
3840 
3850 
3860 
3870 
3880 
3890 
3900 
3910 
3920 
3930 
3940 
3950 
3960 
3970 
3980 
3990 
4000 
4010 
4020 
4030 
4040 
4050 
4060 
4070 
4080 
4090 
4100 
4110 
4120 
4130 
4140 
4150 
4160 
4170 
4180 
4190 
4200 
4210 
4220 
4230 
4240 
4250 
4260 
4270 
4280 
4290 
4300 
4310 
4320 
4330 

4340 
4350 
4360 
4370 
4380 
4390 
4400 
4410 
4420 
4430 
4440 
4450 
4460 
4470 
4480 
4490 
4500 
4510 
4520 
4530 
4540 
4550 
4560 
4570 
4580 
4590 
4600 
4610 
4620 
4630 
4640 
4650 
4660 
4670 
4680 
4690 
4700 
4710 
4720 
4730 
4740 
4750 
4760 
4770 



_8_ 



LDX ttS50 

LDA tt3 ;open Chan 85 

STA ICCOM,X 

LDA 86 ;directory 

STA ICAUX1,X 

LDA 8 >DIRNAM ;D1:*.» 

STA ICBAH, X 

LDA 8 <DIRNAM 

STA ICBAL, X 

JSR CIO ;openning 

BPL NOERRl ;no error 

bmi endir ;opps 



NOERRl LDX 8$50 
LDA 828 
STA ICBLL,X 
LDA 80 
STA ICBLH,X 
LDA 8 >DIRBUF ; ny buffer 
STA ICBAH,X 
LDA 8 <DIRBUF 
STA ICBAL,X 
LDA 85 
STA ICCOM,X 
JSR CIO 
BMI ENDIR 



;chan 5 
j20 chars 

; f or input 



jget bytes 

;get "en 
; error-quit 



LDX 8S00 

LDA 89 ;put bytes 

STA ICCOM 

LDA 820 ;20 of 'en 

STA ICBLL 

STX ICBLH 

LDA 8 >DIRBUF ; ny buffer 

STA ICBAH 

LDA 8 <DIRBUF 

STA ICBAL 

JSR CIO ;print "en 

BPL NOERRl ;ok 
ENDIR JSR CLOSES ;ClOSe 85 

JMP EXIT2 JtO BASIC 
i 
jclose iocb 85 

CL05E5 LDX 8S50 
LDA 8S0C 
STA ICCOM, X 
JSR CIO 
RTS 

;do xios using CIO 

DOXIO PHA ;saue connand 

J5R CL0SE5 ;close chan 

JSR TURNOF ;trace off 

PLA ;get XIO 

LDX 8$S0 ; connand 

STA ICCOM, X 

LDA 80 ;zero length 

STA ICBLH. X 

STA ICBLL, X 

LDA 8 <LBUF+4 ;D:filespec 

STA ICBAL, X 

LDA 8 >LBUF+4 

STA ICBAH, X 

JSR CIO ;do XIO 

TYA 

BPL ENDIR 

JMP ERROR 

;XIO jnp table 

ERA LDA 833 

BNE DOXIO 
LOCK LDA 835 

BNE DOXIO 
UNLOCK LDA 836 

BNE DOXIO 
RENAM LDA 832 

BNE DOXIO 
DOS LDA SYSRST+1 jresstore 

STA DOSINI JDOSINI 

LDA SYSR5T+2 jvector 

STA DOSINI+1 

JSR TURNOF ;trace off 
JMP WARMST ;do warn start 

turn trace on 
special display list 
fron ANALOG issue 31 
June 1985 page 74 



I 



SO 

O 

© 

3D 
b 

f 

5 

-I 

2 
© 

(A 



jerase file 
;Iock a 
;unlock it 



file 



;renane it 



TRACE LDA TFLG 
BNE AON 
INC TFLG 
LDA DLISTL 
STA DLS 
CLC 

ADC 83 
STA BACK 



;check flag 
;l = on now 
;set to l 
;get display 
; 1 ist and 
;save it 

;put it into 



NOVEMBER A.IM.A.L.O.Q. Computing 



8 



it 



FEATURE 





4780 




LDO 


DLI5TH , 


ny display 


5760 


5ED 




jdecinal node 


6740 




LDA 


LBUF,Y 


jhex in 




4790 




STA 


DLH , 


list 


5770 


LDY 


8$10 


;16 bits 


6750 




CMP 


8'$ 


J "HEXtSlhhhh" 
jskip 'S' 




4800 




ADC 


88 




5780 U4 ASL 


BFRO 


;2 BCD digits 


6760 




BNE 


HD1 




4810 




STA 


BACK+1 




5790 


ROL 


BFR1 


;per byte 


6770 




INY 








4820 




LDO 


8 >NDLIST ; install 


5800 


LDX 


tt$03 


;6 BCD digits 


6780 


1D1 


LDX 


ttO 


jclear work 




4830 




STft 


DLI5TH , 


the new 


5810 


J5 LDA 


BCD,X 


;total 


6790 




STX 


FRO 


jspace 




4840 




LDO 


tt <HDLIST sspecial 


5828 


ADC 


BCD,X 




6388 




STX 


FR0 + 1 






4850 




5T0 


DLI5TL 


display 


5838 


STO 


BCD,X 




6818 




STX 


X2 


jdigit countr 




4860 




LDO 


86 j 


list 


5840 


DEX 






6828 


PU1 


LDA 


LBUF, Y 


jget digit 




4870 




LDY 


tt <UBI 


turn on 


5850 


BNE 


U5 




6838 




LDX 


tt$0F 


jin table 




4880 




LDX 


tt >UBI , 


UBI 


5860 


DEY 






6848 


H2 


CMP 


HEXTAB, X 






4890 




J5R 


SETUBU 




5870 


BNE 


U4 




6858 




BEQ 


H3 


jX = 0-15 




4900 


»0N 


J MP 


EXIT2 


out 


5880 


CLD 




;clear decinal 


6860 




DEX 








4910 










5890 


LDX 


825 


jput digits on 


6870 




BPL 


H2 






4920 


:turn off UBI 




5900 


LDY 


80 


;top line 


6880 




BMI 


H6 


joh! oh! 




4930 










5910 


U6 LDO 


BCD+1, Y 




6890 


H3 


STX 


XI 


j= O <-> 15 




4940 


TOFF JSR 


TURHOF 


turn NUM off 


5920 


PHO 




Jhigh nibble 


6900 


J 










4950 




J MP 


EXIT2 


goto BASIC 


5930 


L5R 


A 




6910 


;convert to binary 




4960 


; 








5940 


L5R 


A 




6920 


t 










4970 


TURHOF LDO DLH 


restore 


5950 


LSR 


A 




6930 




ASL 


FRO 


jtines 16 




4980 




STO 


DLISTH 


original 


5960 


LSR 


A 




6940 




ROL 


FR0 + 1 






4990 




LDO 


DLS 


display list 


5970 


ORA 


tt$18 


; internal code 


6950 




ASL 


FRO 






5000 




STO 


DLI5TL 




5980 


STA 


TLINE,X 




6960 




ROL 


FRO+1 






5010 




LDO 


ao 


;set flag 


5990 


INX 






6970 




ASL 


FRO 






5820 




STO 


TFLG 




6000 


PLA 




;get byte 


6980 




ROL 


FRB+1 






5030 




LDX 


SYSUBU+2 


;reset UBI 


6010 


AND 


8S8F 


; low nibble 


6998 




ASL 


FRB 






5040 




LDY 


SYSUBU+1 


;to systen 


6020 


ORA 


tt$18 


;internal code 


7868 




ROL 


FR8+1 






5050 




LDO 


86 


; vectors 


6030 


STA 


TLINE,X 




7810 




CLD 








5060 




JSR 


SETUBU 




6040 


INX 






7028 




CLC 








5070 




RT5 






6050 


INY 






7038 




LDA 


FRO 


jadd in value 




5080 


; 








6060 


CPY 


83 


jdone? 


7040 




ADC 


XI 


J 8<-> 15 


o 

2 


5090 


;pr 


int error Message 


6O70 


BNE 


V6 


j no 


7050 




STft 


FR0 




5100 


; 








6080 


JMP 


SY5UBU 


jgone 


7060 




LDO 


FR0+1 




5110 


ERROR PHA 


jsave error tt 


6090 


i 






7078 




ODC 


80 




5120 




LDX 


tt7 




6100 


; convert dec to 


hex 


7080 




STA 


FR0+1 




in 


5130 


Ell 


LDO 


ERMES,X 


;get byte 


6110 


t 






7098 




INY 




jnext dec digit 


v» 


5140 




JSR 


PUTC 


; print it 


6120 


DECHEX LDft 83 


;point to 8 


7188 




INC 


X2 


jhex counter 




5150 




DEX 






6130 


STA 


CIX 


;in -DECdddd" 


7110 




LDA 


X2 




ml 


5160 




BPL 


Ell 




6140 


LDA 


tt >LBUF 




7120 




CMP 


84 


j got 4 


ag 


5170 




PLO 




;get error 


6150 


STA 


INBUF+1 


,'point FP 


7138 




BEQ 


H6 


j yes 




5180 




STO 


FRO 




6160 


LDA 


8 <LBUF 


jto it 


7140 




JMP 


PU1 


jdo nore 


5190 




LDO 


BO 




6178 


STA 


IMBUF 




7158 


H6 


LDA 


X2 


J8 digits 






5200 




STO 


FR1 




6180 


JSR 


AFP 


;to FP 


7168 




BNE 


H7 




5210 




JSR 


IFP 


;convert to 


6198 


BCC 


DD2 


jok 


7178 




JMP 


UALERR 


■ error 


5220 




JSR 


FftSC 


JATA5CII 


6200 


JMP 


VALERR 


j error 


7188 


; 








5230 




JSR 


MPRIHT 




6210 


DD2 JSR 


FPI 


jto integer 


7198 


;convert to ATASCII $ print 


5240 




JSR 


DOCR 




6228 


JSR 


BNTOHX 


;to hex digits 


7200 


i 








n 


5250 




JSR 


PRRDY 




6230 


LDA 


8' = 




7210 


H7 


JSR 


IFP 




5260 




JMP 


EHDIR 




6240 


JSR 


PUTC 


j ■=$■ 


7220 




JSR 


FA5C 


jto ATASCII 


^ 


5270 


; 








6250 


LDO 


8'$ 




7238 




LDA 


tt' = 






5280 


;pr 


itlt "R! 




6260 


JSR 


PUTC 




7248 




JSR 


PUTC 




•■ 


5290 


1 








6278 


LDX 


83 


jprint the 


7250 




LDX 


80 




•*• 


5300 


PRRDY LDX t»5 




6288 


DD1 LDA 


N2BUF,X 


jhex digits 


7268 


H9 


LDA 


LBUF,X 




5 


5310 


rdy 


LDO 


REOD,X 




6298 


JSR 


PUTC 




7278 




PHO 




jsave it 


V 


5320 




JSR 


PUTC 




6380 


DEX 






7288 




AND 


8$7F 


jnask inverse 




5338 




DEX 






6310 


BPL 


DD1 




7290 




JSR 


PUTC 




T 


5340 




BPL 


RDY 




6328 


JSR 


DOCR 




7360 




INX 






5350 




RTS 






6330 


JSR 


SETLBF 


j reset 


7318 




PLA 




jget it 


*• 


5360 


• 








6340 


LDA 


88 


jfp stuff 


7320 




BPL 


H9 


j nore 


■ 


5370 


jvert blank code 


for trace 


6358 


STA 


CIX 




7330 




JSR 


DOCR 




■ 


5380 


• 








6360 


JMP 


EXIT2 


Jto BASIC 


7340 




JSR 


SETLBF 


jreset LBUF 


■ 


5390 


UBI 


LDO 


CRITIC 


; critical 


6370 


i 






7350 




JMP 


EXIT2 


jto BASIC 


■ 


5400 




BEQ 


U3 


;section? no 


6380 


jdo a carriage 


return 


7368 


1 








| 


5410 




JMP 


SYSUBU 


JOUt 


6390 


J 






7370 


jdo listing of 


variables 




5420 


U3 


LDO 


DLISTL 


;see if special 


6400 


DOCR LDA 8E0L 




7388 


J 










5430 




CMP 


8 <HDLI5T Jdisplay list 


6410 


JSR 


PUTC 




7390 


UARLST 


LDft UNTP 


jpoint to 




5440 




BNE 


PUTDL 


; is present 


6420 


RTS 






7408 




STA 


JO 


j variable 




5450 




LDO 


DLISTH 


;if not - forn 


6430 


, 






7418 




LDA 


UNTP+1 


jtable 




5460 




CMP 


8 >HDLIST ;it 


6440 


jbinary 


to hex 


converter 


7428 




STA 


JO+1 






5470 




BEQ 


U9 


jyes 


6450 


i 






7438 




LDA 


8$7F 


j first var=$80 




5480 


PUTDL 


; save it 


6460 


BNTOHX 


LDY 83 


j work backwards 


7448 




STA 


MYTOKEN 






5490 




STO 


DLS 




6470 


LDX 


81 


;2 hex nuMbers 


7458 


LSBEG 






5500 




CLC 






6480 


HX1 STX 


X3 




7468 




CMP 


$85 


;at end of 




5510 




ODC 


tt3 


; instal 1 in 


6490 


LDA 


FR0,X 


jget high 


7478 




BNE 


LPUAR 


jvar table? 




5520 




STO 


BACK 


;new display 


6508 


PHA 




jsave it 


7488 




LDA 


JO 






5530 




LDO 


DLISTH 


;list 


6518 


LSR 





j nove to 


7498 




CMP 


$84 






5540 




STO 


DLH 




6528 


LSR 





j low nibble 


7588 




BNE 


LPUAR 






5558 




ODC 


no 




6538 


LSR 


ft 




7518 




JMP 


EXIT2 


Jto BASIC 




5560 




STO 


BACK+1 




6540 


LSR 


ft 




7520 


J 










5570 




LDO 


8 <NDLIST 


6550 


i 






7530 


LPUAR LDY 8$00 


j print variabl 




5580 




STO 


DLISTL 




6560 


TAX 






7540 




LDA 


CJOJ,Y 






5598 




LDO 


8 >NDLIST 


6570 


LDA 


HEXTAB, 


X jget hex digit 


7550 




PHA 




jsave it 




5600 




STft 


DLISTH 




6580 


STO 


N2BUF,Y 


jstore it 


7560 




AND 


8$7F 


jnask inverse 




5610 


U9 


LDft 


$80 


;get executing 


6590 


DEY 




j nove pointer 


7570 




JSR 


PUTC 


jto screen 




5620 




STft 


$04 


;line pointer 


6600 


PLO 




j down 


7580 




INC 


JO 


j nove pntr up 




5630 




LDft 


$8B 




6610 


AND 


8$8F 


jnow low nibble 


7590 




BNE 


LU1 






5648 




STft 


$85 




6620 


TAX 






7600 




INC 


JO + 1 






5658 




LDY 


ttO 


;get executing 


6630 


LDA 


HEXTAB, 


X jget hex 


7610 


LU1 PLA 




jget byte 




5660 




LDft 


{$04} ,Y 


;line no. 


6640 


STA 


H2BUF,Y 


jsave it 


7620 




BPL 


LPUAR 


j nore if + 




5670 




STft 


BFRO 




6650 


DEY 






7630 




JSR 


DOCR 


Jdo CR 




5688 




INY 






6660 


LDX 


X3 


j next hex nunbr 


7640 




LDA 


STMTAB 


jget start of 




5690 




LDO 


C$043 , Y 




6678 


DEX 






7650 




STA 


LO 


; BASIC 




5700 




STft 


BFR1 




6688 


BPL 


HX1 




7660 




LDA 


STMTAB+1 j lines 




5710 




LDO 


tte 


iclear out BCD 


6698 


RTS 




jdone 


7670 




STA 


LO + 1 






5720 




STft 


BCD 


;work space 


6788 


i 






7688 




LDA 


80 


jcolunn cntr 




5730 




STft 


BCD+i 




6710 


;hex to 


dec converter 


7698 




5TA 


PRFLAG 






5740 




STO 


BCD + 2 




6720 


i 






7780 




INC 


MYTOKEN 


jnext variable 




5750 




STft 


BCD + 3 




6730 


HEXDEC 


LDY 83 


jpoint to 


7710 


I 









(CONTINUED ON PAGE I I 7) 
NOVEMBER A.IM.A.L.O.C5. Computing 



The 



Compukid Connection 



ST 



Ci V L. [■!_ L 

The holidays are approaching, and par- 
ents will be considering gifts to buy for their 
children. If your children enjoy your ST, a 
computer-related gift may be just the thing. 

If it's software you're looking for, you will 
be pleased to know that truly excellent pro- 
grams can be had cheaply or at no cost. 
Last winter I discovered several arcade 
packages on the market. These "best hits" 
are groups of three or more of the older ar- 
cade games (six months or more past the 
release date); they are sold as one unit for 
the price of a single brand-new release. 
Some of the packages contain duds, but 
more typically, all of the programs in a 
package are high-quality arcades. Two such 
packages were a big hit with our three old- 
er boys last December. 

At nominal cost or at no cost at all, you 
can obtain public-domain or freely dis- 
tributed programs of high quality. [ST-LOG 
programs are not in the public domain; even 
though we allow limited distribution, we re- 
tain all rights— ed.] Some of these can be 
customized to create personal software gifts. 
For example, last December I noticed in the 
documentation for Monkeys and Balloons 
by Frank Cohen (from the October 1988 is- 
sue of ST-LOG) that he suggested customiz- 
ing his program by altering the DEGAS Elite 
.PCI files. I took a fresh look at the pro- 
gram, a version of Breakout in which the 
mouse controls two monkeys holding a 
trampoline. A clown bounces off the tram- 
poline in an attempt to pop balloons over- 
head. I altered the DEGAS pictures so that 
the clown resembled my then-five-year-old 
daughter, Catherine, complete with eye- 
glasses and a letter "C" on her sweatshirt, 
and the monkeys were made to look like her 
brothers, Willy and Joey. The final prod- 
uct was copied to a green disk and a red 
label was attached. She loved it! 

That same year I downloaded a program 
from GEnie called HANGOPUS by B. 
Cafferky for my son,Willy, a Bloom Coun- 
ty fan. This version of Hangman lets you 
create word-puzzle files. I made files for 
Willy that included vocabulary from his 
hobbies. The resulting program was copied 
to a special red disk. There are many other 
public-domain programs that include the 
possibility of customization. And there are 
hundreds of other challenging public- 
domain games for children; your online ser- 
vice, user's group library or public-domain 
dealer will have many fine offerings. 
The holidays are also a good time to con- 
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sider a new set of joysticks; certainly, ours 
have a life expectancy of less than a year. 
Another accessory a child really appreci- 
ates is a joystick extender. These are short 
cords with a male joystick plug at one end 
and a female plug at the other. They are in- 
serted into the joystick and mouse ports of 
your computer; when the child must remove 
joysticks or the mouse, the device is un- 
plugged from the extender and not from the 
computer, thus saving wear and tear on the 
computer's ports. Extenders also make 
changing joysticks on a 1040 much more 
convenient. Though not quite as exciting as 
a new game, mouse pads are appreciated 
by children also. 

Tannenbaum 

The Germanic tribes in ancient times had 
a long-standing reverence for the evergreen 
tree (Tannenbaum). These trees demonstrat- 
ed that life could continue even in the 
"dead" of winter. To celebrate this sign of 
life, they brought the trees into their homes 
in the winter. When these people became 
Christians, they retained their pagan cus- 
tom. As the evergreen ritual coincided with 
the celebration of Christmas, it eventually 
became part of that celebration: the Christ- 
mas tree. 

My mother always enjoyed decorating for 
the holiday season, and the focal point of 
her endeavors was the Christmas tree. We 
brought home a huge tree every year and 
stood it up in our front hallway, where it 
was circled by the main stairway. We chil- 
dren dropped tinsel and decorations onto its 
top branches from the balcony. 

This holiday season, you and your child 
can enjoy the fun of decorating the tree 
without a trip to the attic to gather box upon 



box of bulbs and bells. Tannenbaum, on this 
month's ST-LOG disk, is a music-and- 
design program with a holiday theme. It is 
intended for use by children as young as two 
or three. The child (or adult!) uses the 
mouse to choose from a variety of animat- 
ed and nonanimated decorations to decorate 
a Christmas tree. The animation of the 
decorations (twinkling bulbs and more) can 
then be set into motion while the computer 
plays the traditional German holiday song, 
"O Tannenbaum!" 

Getting Started 

To use the program, deARC the file TAN- 
NENBM.ARC and copy TAN- 
NENBM.PRG, TANNENBM.PI1, 
TANNENSP.MBK and TANNENMU.MBK 
to a freshly formatted disk. (The other file 
in the ARCed file, TANNENBM.BAS, is 
the STOS BASIC source code for the pro- 
gram; you will need it only if you want to 
examine the program's construction with the 
STOS interpreter.) The program will work 
if placed within a folder, so long as all four 
needed files are present in that folder. The 
program will run on any ST with a color 
monitor. To run the program from your ST's 
desktop, be sure that your screen is in low 
resolution and then double-click on TAN- 
NENBM.PRG in the directory listing. The 
title screen will appear, followed automati- 
cally by the main program screen. 

The Main Screen 

The main screen is divided into three 
areas: the Options menu, the Christmas tree 
display and the decorations boxes. 

The decorations boxes contain two kinds 
of decorations. The bottom row of boxes 
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(two boxes of tinsel and a yellow globe) are 
framed by a gold box. These are nonani- 
mated decorations. You may place any num- 
ber of these decorations on the tree. The 
upper three rows of boxes hold animated 
decorations. Only 14 total animated deco- 
rations can be placed on the tree. These 14 
may be all of one type of decoration, or a 
combination of many. 

The Options menu includes four boxes: 
The EXIT option gives the user an oppor- 
tunity to quit the program and return to the 
desktop. The PLAY option starts the move- 
ment of the animated decorations and the 
accompanying music. Clicking the mouse 
on the PLAY option will cause the com- 
puter to play the tune whether any decora- 
tions are on the tree or not. The NEW 
option erases any and all decorations cur- 
rently placed on the tree. The UNDO op- 
tion erases only the decoration that was last 
selected. 

The Christmas tree display area, of 
course, contains the tree. Decorations can 
be placed almost anywhere within this area; 
it is not necessary to put them directly on 
the tree. Some of the larger decorations can 
be placed so that they nearly touch the rec- 
tangle surrounding the tree display, but 
others must be placed a bit farther inside 
the perimeter. 

Using the Program 

To choose a decoration, point the mouse 
arrow at any of the items in the decorations 
boxes and click either or both mouse but- 
tons. The mouse arrow will disappear, and 
in its place will be a copy of the decoration 
you have chosen. Move the mouse to the 
tree display and position the decoration 
wherever you choose. Then press either or 
both mouse buttons again to put the deco- 
ration in place. If the position is not pre- 
cisely what you'd like, click UNDO and 
repeat the procedure. 

When your tree is trimmed to your satis- 
faction, click PLAY and watch the decora- 
tions move while the music plays. You can 
speed up or slow down the tempo by press- 
ing any of the function keys on the top row 
of your ST's keyboard. The original tempo 
of the music as presented can be restored 
by pressing the F4 key. After the song is 
over, the mouse will reappear, and you can 
make other selections. 

Special Effects 

The function keys do not affect the speed 
of the animations. To achieve the fastest ani- 
mation of a decoration, use only one sin- 
gle decoration; the computer will animate 
one decoration much faster than it will 15. 



Children may enjoy exploring symmetry 
on this rather symmetrical representation of 
a tree. A pyramid of angels, a flock of birds 
and numerous combinations can demon- 
strate such balance. 

Don't neglect the black areas of the tree 
display. Twinkling stars are just as charm- 
ing when hanging from your display ceil- 
ing as they are on the tree. 

Certain combinations of decorations or 
their unusual placement can yield surpris- 
ing results and expand the ability of the pro- 
gram to mimic an actual Christmas tree. For 
example, the tinsel supplied in the decora- 
tions boxes can imitate candlesticks or true 
icicles, depending on where it is displayed. 
I chose to draw rather globby chunks of tin- 
sel because that is how my children apply 
tinsel to a real tree. When combined with 
one of the small globes or the twinkling star, 
however, the tinsel becomes a convincing 
candlestick. 

Some decorations are especially pleasing 
when placed so that they overlap others of 
the same or different type. The effect of 
such displays, when animated, can be quite 
striking. When two decorations overlap, 
STOS gives priority to the decoration that 
is lower down on the screen. When you 
choose a decoration and move it around in 
the display area, you will notice that it 
sometimes seems to be on top of other deco- 
rations and sometimes behind (or under- 
neath) them. This is quite effective in 
duplicating the layered look of a Christmas 
tree. When animated, the priority of the 
decorations relative to one another is 
preserved; if a bird is behind a pinwheel 
when placed on the tree display, it will con- 
tinue to be behind the pinwheel while both 
are animated. 

The nonanimated decorations in the bot- 
tom row of the decorations boxes have the 
lowest priority. A nonanimated decoration 
will always be behind the animated deco- 
rations. The only exception occurs when the 
nonanimated decoration is the last decora- 
tion selected; in this case, it will have the 
same priority as the animated decorations. 
To see how this works, place an animated 
decoration on the tree. Then select a deco- 
ration from the bottom row and place it over 
the first one so that the nonanimated deco- 
ration is "on top." Now select another deco- 
ration of any kind. As soon as you select 
another decoration, the nonanimated deco- 
ration moves behind the first one. 

Each type of animated decoration has its 
own animation sequence. When the PLAY 
option is selected, the first animated deco- 
ration the computer changes is the one you 
placed on the tree first. The next one to 
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change is the one you placed second, and 
so on. The order of animation (and thus the 
order in which you have placed the deco- 
rations on the tree) can be an important in- 
fluence on the effectiveness of your display. 
To get started in experimenting with these 
effects, try placing pinwheels in a row. Place 
the first pinwheel near the upper left-hand 
corner of the tree display. Then place an- 
other pinwheel just a bit to the right of it, 
so that it overlaps the blades on the right 
side of the first pinwheel. Add more pin- 
wheels to this row and then click the mouse 
on PLAY. Many other types of decorations 
can produce such interesting effects when 
used alone or in combination with other 
types. 

Sing Along! 

Many children, at least when prodded, 
enjoy singing along with music programs. 
Below, I provide an English-language ver- 
sion of the song for those of you who may 
not be familiar with it. (Note that this ver- 
sion, by John W Schaum, is not a direct 
translation of the German, though it does 
effectively convey the spirit.) 

O Christmas Tree! Christmas Tree! 

Your lovely branches thrill me. 

O Christmas Tree! Christmas Tree! 

You fill my heart with glee. 

Your ornaments of red and blue, 

Your pretty lights of many hues, 

Christmas Tree! Christmas Tree! 
Your lovely branches thrill me. 
Before closing, I want to thank David 

Plotkin for his valuable assistance in the de- 
velopment of this program. This was my 
first effort in STOS, and Mr. Plotkin's con- 
tribution of time and wisdom is much ap- 
preciated. 

1 hope you and your children will enjoy 
Tannenbaum. Happy holidays! 




D.A. Brumleve, M.A., is involved with 
children and computers in a variety of ways. 
The mother of five children, ages two to ten, 
she serves as the adult facilitator of the 
Children 's ST Users ' Group in Urbana, Il- 
linois. An avid programmer, she has devel- 
oped a beginner's course in GFA BASIC and 
is the author of PreSchool KidProgs 
(MichTron) and numerous freely distribut- 
ed programs for young ST users. Her 
daughter, Catherine, is a student at Crea- 
tive Discovery School. 
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DISK LISTING 



01-X 



THE NOVEMBER 1989 ANALOG COMPUTING 
8-BIT DISK CONTAINS 18 MAGAZINE FILES. 
THEV ARE LISTED BELOW: 



SIDE 1: 










FILENAME 


.EXT 


LANG. 


LOAD 


ARTICLE NAME 


BUPSVS 


■ OBJ 


ML 


(83) 


BASIC UTILITIES 


BUPP1 


.M65 


MAC/65 


LOAD 


BASIC UTIL. SOURCE 


BUPP2 


,M65 


MAC/65 


LOAD 


BASIC UTIL. SOURCE 


MEMMATCH 


BAS 


BASIC 


LOAD 


MEMORY MATCH 


TITLMAKR 


OBJ 


ML 


(83) 


TITLE MAKER 


TITLMAK2 


BAS 


BASIC 


LOAD 


TITLE MAKER, L2 


TITLMAKR 


M65 


MAC/65 


LOAD 


TITLE MAKER SOURCE 


ADDRESS 


BAS 


BASIC 


LOAD 


BASIC TRAINING 


MLEDITOR 


BAS 


BASIC 


LOAD 


M/L EDITOR 


EDITORII 


LST 


BASIC 


ENTER 


BASIC EDITOR II 


TO LOAD YOUR 


ANALOG DISK 





1) INSERT BASIC CARTRIDGE CNOT REQUIRED FOR XE 
OR XL COMPUTERS) . 

2) TURN ON DISK DRIVE AND MONITOR. 

3) INSERT DISK IN DRIVE. 

4) TURN ON COMPUTER. (XL AND XE OWNERS: DO NOT 
HOLD DOWN OPTION KEY!) 



WARNING: BEFORE YOU RUN A PROGRAM, READ THE 

APPROPRIATE ARTICLE IN THE MAGAZINE. 
FAILURE TO DO SO MAY YIELD CONFUSING 
RESULTS. 

NOTE: ONLY PROGRAMS WITH THE .BAS, .COM 
OR .OBJ EXTENSION MAY BE RUN FROM 
THE MENU. OTHER PROGRAMS SHOULD BE 
LOADED AS INSTRUCTED IN THE LOADING 
NOTES AND MAY REQUIRE ADDITIONAL 
SOFTWARE AS LISTED BELOW. HOWEVER, 
YOU SHOULD NOT ASSUME THAT EVERY FILE 
WITH THE PROPER FILE EXTENSION WILL RUN 
FROM THE MENU. YOU MAY HAVE TO MOVE 
CERTAIN PROGRAMS TO A DIFFERENT DISK 
TO OBTAIN CORRECT RESULTS. 



EXT DESCRIPTION 



.M65 REQUIRES 

.AMA REQUIRES 

.ASM REQUIRES 

.ACT REQUIRES 

.LGO REQUIRES 

.SYN REQUIRES 



LOADING NOTES 



THE MAC/65 ASSEMBLER 
THE ATARI MACRO ASSEMBLER 
THE ATARI ASSEMBLER/EDITOR 
THE ACTION! CARTRIDGE 
THE ATARI LOGO CARTRIDGE 
THE SYNAPSE SYN ASSEMBLER 



LOAD BASIC PROGRAM: 
ENTER BASIC PROGRAM: 
LOAD MAC/65 PROGRAM: 
ENTER ASM/ED PROGRAM: 
LOAD LOGO PROGRAM: 
LOAD SYN/AS PROGRAM: 



LOAD "D: FILENAME. 
ENTER "DiFILENAME.EXT" 
LOAD »D:FILENAME.EXT 
ENTER 8D:FILENAME.EXT 
LOAD "D:FILENAME.EXT" 
LOAD "D.-FILENAME.EXT" 



81: SEE ACTION! MANUAL. 

82: SEE ATARI MACRO ASSEMBLER MANUAL. 

83: MAY ALSO BE LOADED FROM DOS USING THE 

OPTION OF THE DOS MENU. 
84: THIS FILE SHOULD BE TRANSFERRED TO ANOTHER 

DISK AND RENAMED "AUTORUN.SYS". 
85: READ THE APPROPRIATE ARTICLE FOR INSTRUCTIONS 

ON USING THIS FILE. 




The NOVEMBER 1989 ANALOG COMPUTING ST disk 
contains 28 Magazine files. They are listed 
below. 



FILENAME. EXT FILE TYPE 



CMANSHIP.ARC contains: 
C78 C C 
C0MB078 !PRG RUN FILE 
MICROCHK.RSC RESOURCE 

ASSEMBLY. ARC contains: 
TEMPLMON.PRG RUN FILE 
TEMPLMON.ENG TEXT 
READ .ME TEXT 

COMPUKID.ARC contains: 
TANNENBM.PRG RUN FILE 
TANNENBM.PI1 DEGAS 
TANNENMU.MBK DATA 
TANNENSP.MBK DATA 
TANNENBM.BAS BASIC 

PDPARADE.ARC contains: 



COMMENTS 

C-MANSHIP 

THE PROGRAM SO FAR 



TEMPLEMON 

INSTRUCTIONS 

INSTRUCTIONS 



0, TANNENBAUM 
PICTURE FILE 



FLU .PRG 
FLU . RSC 
FLU .DOC 
VKILLER .PRG 
VKILLER .RSC 
VKILLER .DOC 



RUN FILE 

RESOURCE 

TEXT 

RUN FILE 

RESOURCE 

TEXT 



STOS SOURCE 



FLU PROGRAM 

INSTRUCTIONS 
VIRUS KILLER 

INSTRUCTIONS 



SURVEY. ARC contains: 

SWEEP .PRG RUN FILE SURVEY SWEEPSTAKES 
QUEST .SWP DATA QUESTION FILE 

SWEEP .LST GFA BASIC 2.8 SOURCE CODE 



ARCX .TTP RUN FILE 
README .DOC TEXT 
UNARCHIV.DOC TEXT 



UNARCHIVING PROGRAM 
Disk instructions 
Unarchiving instructions 



Disk instructions: 

Onlu those files with .PRG, .TOS, or .TTP 
extensions may be run from the GEM desktop. 
Other programs nay require additional software 
as shown below. The files on this disk have 
been archived (compressed) into .ARC files. To 
restore the programs to their runnable form, 
follow the instructions found in the 
UNARCHIV.DOC file. 



Be sure to read the appropriate magazine 
articles before attempting to run the programs 
on this disk. Failure to do so nay yield 
confusing results. 

HMbB 



EXT DESCRIPTION 



Requires GFA BASIC 
Requires GFA BASIC 
Requires C compiler 
Requires 68880 assembler 
Requires Pascal compiler 
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UTILITY 




l=Mh-M;] 



8 



i-* 



the two-letter 

checksum code 

preceding the line 

numbers here is not a 

part of the BASIC 

program. For more 

information, see the 

"BASIC Editor II" 

elsewhere in this 

issue. 



M/L 



Editor provides an easy 
method with which 
to enter our machine- 
language listings. It 
won't allow you to 
skip lines or enter bad data. For con- 
venience, you may enter listings in multi- 
ple sittings. When you're through typing a 
listing with M/L Editor, you'll have a com- 
plete runnable object file on your disk. 

There is one hitch: It's for disk users only. 
My apologies to those with cassette 
systems. 

Listing 1 is M/L Editor's BASIC listing. 
Type it in and, when it's free of typos, save 
a copy to disk, then run it. 

On a first run, you'll be asked if you're 
starting a new listing or continuing from a 
previously saved point. Press S to start or 
C to continue. 

You'll then be asked for a filename. If 
you're starting a new listing, type in the file- 
name you want to save the program under, 
then press Return. If there's already a file 
by that name on the disk, you'll be asked 
if you wish to delete it. Press Y to delete 
the file or N to enter a new filename. 

If you're continuing a file, type in the 
name you gave the file when you started it. 
If the program can't find the file, you'll get 
an error message and be prompted for an- 
other filename. Otherwise, M/L Editor will 
calculate where you left off, then go on to 
the data-entry screen. 

Each machine-language program in 
ANALOG Computing is represented by a 
list of BASIC data statements. Every line 
contains 16 bytes, plus a checksum. Only 
the numbers following the word DATA 
need to be considered. 

M/L Editor will display, at the top of 
the screen, the number of the line you're 
currently working on. As you go through 
the line, you'll be prompted for each en- 
try. Simply type the number and press Re- 



turn. If you press Return without a 
number, the default is the last value 
entered. 

This feature provides a quick way to 
type in lines with repetitions of the same 
number. As an added convenience, the 
editor will not respond to the letter keys 
(except Q for "quit"). You must either en- 
ter a number or press Return. 

When you finish a line, M/L Editor 
will compare the entries' checksums with 
the magazine's checksum. If they match, 
the screen will clear, and you may go on 
to the next line. 

If the checksums don't match, you'll 
hear a buzzing sound. The screen will 
turn red, and the cursor will be placed 
back at the first byte of data. Compare 
the magazine listing byte by byte with 
your entries. If a number is correct, press 
Return. 

If you find an error, make the correc- 
tion. When all data is valid, the screen 
will return to gray, and you'll be allowed 
to begin the next line. 

Make sure you leave your disk in the 
drive while typing. The data is saved con- 
tinuously. 

You may stop at any time (except when 
you have a red screen) by entering the let- 
ter Q for byte 1. The file will be closed, 
and the program will return you to BA- 
SIC. When you've completed a file, exit 
M/L Editor in the same way. 

When you've finished typing a pro- 
gram, the file you've created will be ready 
to run. In most cases, it should be load- 
ed from DOS via the L option. Some pro- 
grams may have special loading 
instructions; be sure to check the pro- 
gram's article. 

If you want the program to run auto- 
matically when you boot the disk, sim- 
ply name the file AUTORUN.SYS (make 
sure you have DOS on the disk). 



ihWMII^r-IHihJHM 



M 19 DIM BF(16) ,HS(4) ,ASC1) ,BS(1) ,FS(15) 

,F1$(151 
LF 11 DIM MODS 14] 
t» 20 LINE=1008:RETRH=155:BACK5P=126:CHKS 

UM=0:EDIT=0 
GO 30 G05UB 45B:P0SITI0N 18,61? "Start or 
; Continue? "HG05UB 500:? CHRS (A) 

ZC 40 POSITION 10, 8i? "FILENAME") : INPUT F 

SiPOKE 752,1!? " " 
fE 58 IF LEN1FSX3 THEN POSITION 28,18:? 

& G8TB 48 

»r 68 IF FSC1,2)<>"D!" THEN FlS="D I " ! FlS C 

J)=F$!G0T0 8B 
«. 78 FISzFS 

IN 88 IF CHRStA>="5" THEN 128 
F» SB TRAP 43B:0PEN tt2, 4, 0, FlS : TRAP 118 
Htt 188 FOR X = l TO 16!GET tlZ,0:NEXT XiLIHE 

=line*ib:goto iob 
mm 118 close h2:0pen 112 , 9 , , fls : goto 17b 
vt 128 trap 16b10pen 112 , 4 , , fls : g05ub 44b 

ip05iti0h 18,18!? "file already exi5t5 

! !"!P0KE 752,8 
Ztl 130 POSITION 18,12!? "ERASE IT? "JiGOS 

UB 580!P0KE 752,1!? CHRStA) 
MB 148 IF CHRSlA)="N" OR CHRS IAJ ="n" THEN 

CLOSE 112! GOTO 3B 
OC 158 IF CHRS(A)<>"Y" AND CHRS CA) <> "V" T 

HEH 138 

BH 168 CL05E tt2!0PEN t!2,8,B,FlS 

IE 17B G05UB 450!P05ITI0N 10,1!? "UnEMUJI 

HUH! ";line:chksum=b 

CH 180 L1=3:F0R X=l TO 16-.P05ITI0N 13*CH< 
101*12»{X>9>,X*2:P0KE 752,8!? "BYTE tt" 

;X;"i "; :GBSUB 318 

KK 190 IF EDIT AND L=B THEN BYTE=BF CX) : GO 

TO 218 
FY 280 BYTE=UALCNSJ 
OZ 281 MODSzNS 

BU 210 POSITION 22,X*2:? BYTE;" " 
YZ 228 BFCX)=BYTE:CHKSUM=CHK5UM»BYTEXX:IF 

CHK5UM>9999 THEN CHK5UM=CHK5UM-10008 
MS 230 NEXT X! CHK5UM=CHK5IIM»LINE : IF CHKSU 

M>9999 THEN CHK5UM=CI(K5UM-10008 
XG 240 POSITION 12,X»2:P0KE 752,81? "CHEC 

KSUM! ■■; :L1=4:G05UB 318 
EH 258 IF EDIT AND L=B THEN 27B 
OH 268 C=VAL(NSJ 

%t 278 POSITION 22,X*2I? Cj" " 
It 280 IF C = CHK5UM THEN 300 

DI 290 G05UB 440!EDIT=1!CHK5UM=8!G0T0 188 
LH 300 FOR X=l TO 16!PUT H2, BF (X) I NEXT X! 

LII1E = LINE + 10:EDIT = 0:G0T0 17B 
rV 310 L = 
KZ 320 GOSUB 508!IF (A=ASCC"Q") OR 0=05CC 

"q")> AND X=l AND NOT EDIT THEN 420 
PO 330 IF AORETRN AND AOBACKSP AND CA<4 

8 BR A>57) THEN 328 
DK 331 IF A=RETRN AND H$="" THEN N$=H0D$ 
TD 335 IF A=RETRN AND L=B AND X>1 THEN 35 

B 
JR 340 IF tCA=RETRN AND NOT EDIT1 OR A=B 

ACK5P) AND L=0 THEN 320 
DM 358 IF AORETRN THEN POKE 752,1!? " "!R 

ETURN 
GG 368 IF AOBACKSP THEN 408 
SA 378 IF L>1 THEN NS=NS (1, L-l) ! GOTO 390 
AS 380 NS="" 

RE 390 ? CHRSCBACK5P) i !L=L-1!G0T0 320 
BB 400 L = L + l:IF L>L1 THEN A=J1ETRN ! GOTO 35 



HX 410 NS(L)=CHRSCA) 
KH 420 GRAPHICS ! EN 
Yf 430 GOSUB 440!P0S 

H FILE!"! FOR X: 

M2!G0T0 30 
F» 440 POKE 710,48 

=1 TO 50: NEXT X 
MY 450 GRAPHICS 23 

,112!P0KE 559,0 
XR 460 DL=PEEK(560)t 

DL-1,70:P0KE DL+2 
HH 478 FOR X=3 TO 39 

EXT X:F0R X=4 TO 

ZH 480 POKE 0L*41,65 
!P0KE 0L+43,PEEK( 

AC 490 POSITION 2, 

POKE 559,34:RETUR 

HZ 500 OPEN 111,4,8," 
! RETURN 



!? CHRS (A) j :G0T0 320 

D 

ITION 10,10!? "NO 5UC 

TO 1000!NEXT X!CL0SE 

OUND 8,lO0,12,B:F0R X 
OUND 8,0,0,0:RETURN 
OKE 16,11Z:P0KE 53774 
OKE 718,4 

2S6«PEEKC561)+4:P0KE 
6 

STEP 2:P0KE DL+X,2:N 
8 5TEP 2:P0KE DL*X,0 

POKE DL*42,PEEKC560) 
561) !P0KE 87,0 

"analog Ml editor"! 

:GET ttl,A:CLOSE HI 



11D 
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American Techna- Vision 

For Orders Only - 1-800-551-9995 
CA. Orders / Info. - 415-352-3787 



1050 MECHANISM 

Factory fresh TANDON mechs. 
make difficult repairs a snap. Units 
are complete with Head, Stepper, 
Spindle motor, belt etc. Just plug in, 
no difficult alignments or adjust- 
ments required. 

$/!750 



'47 



VISICALC 

SPREADSHEET 

Unleash the computing power t . Q[ 
o! your 8 bit Atari withVisicalc. * 1Q ' 
Compute everything from home ^ 

finances to high powered finan- DISK 

ciai projections. Hundreds of uses. 



ST SPECIALS 

ST SOFTWARE THIS BOX ONLY! 

• Ninja Mission - Arcade Game . . . ,$9.95 

• 221-B Baker St $14.50 

• 221-B Baker Case Library 1 $10.00 

• 221-B Baker Case Library 2 $10.00 

• Time & Magic - Adventure $14.50 

• Cosmic Relief - Arcade Game . . .$14.50 



800 4 PIECE BOARD SET 

Includes Main Board, Power Supply 
Assembly, CPU Module and 10K 
Revision B Operating System Module. 
All boards are new, tested and complete 
with all components $28.50 



800/400 MODULES 
NEW PARTS COMPLETE WITH IC'S 

• CX853 16K RAM Module $9.50 

• 800/400 CPU with GTIA . $8.75 

• 800 10K "B" OS MODULE $8.75 

• 800 POWER BOARD . . . .$14.50 
■ 400 POWER BOARD .... $9.50 



INTEGRATED CIRCUITS 



•C0 14795,. $4.50 

• CO14805 . . $4.50 
■ C012296 . . $4.50 

• CO10745 . . $4.50 
•C0 14377.. $4.50 

• CO60472 . . $4.50 

• 6532 $4.50 

■C012399B $4.50 

• C012499B $4.50 

• C0M599B $4.50 
•CO14806.. $4.50 
•C0 10750.. $4.50 
•CO10444.. $8.50 

• CO60302 $9.50 

• C021697 $15.00 

• C061991 $15.00 

• C061598 . $20.00 

• C061618 $24.00 

• C024947 $15.00 



1050 IC'S 
U7- 6532 $4.50 
U8 - 6810 $4.50 
U9 - 6507 $4.50 
U10 ROM $19.50 
U13 2793 $19.50 
U5 LM2917$8.50 
5713 $5.25 
All other 1050 IC's 

$3.75 each 
Specify by Socket# 

850 INTERFACE 
12 Piece Chip set. 
Includes all plug in 
IC'S except ROM. 
Replacement fixes 
vast majority of 850 
failures $19.50 



TOWER PACKS 

Exact replacement trans- 
former for 800/400, 1050 
810, 1200XL, 850, and 
XF551 unils. Part #C0 17945. 



$-|450 



XL/XE SUPPLY „__„. 

PowxPakforBOOXL.eCOXL 3>Qk00| 
130XE, 65XE & XE Game. C.\J 



THE BOOKKEEPER 
AND CX85 KEYPAD 

You get both Atari's 8 bit 
professional bookkeeping $ ^Q95| 
system and the handy CX85 I <D 

numeric keypad for one low 4 DISK 
price. Packages Factory sealed. SET 



KEYBOARDS 

New and complete subassembly. 
Easy internal replacement. 

T30XE/65XE $35.00 

800 $40.00 

800XL $29.50 

400 $12.50 



REPAIR MANUALS 

SAMS Service Manuals for the 
following units contain schematics, 
parts listings, labelled photographs 
s howi ng the location of 
checkpoints and more! A special 
section gives oscilloscope and 
logic probe readings allowing you 
to narrow the malfunction down to 
a specific chip or transistor! 
800, 800XL, 130XE, 400, 1025 

and 1050 $19.50 each 

520ST Service Manual. $37.50 

40 PIN LSI CHIPSET 

Complete set of 40 Pin Large 
Scale Integrated Circuits for 
800XL, 600XL, 1200XL. $19.95 

MISCELLANEOUS 

13 Pin Serial I/O Cable $4.50 

600XL 64K Upgrade Kit . . $29.95 

ACE Joystick $7.95 

1050 Track Zero Sensor . . . $8.50 
2793 1050 Controller IC . . . $19.50 

U.S. Doubter $29.95 

400 Board Set (W/O Kybd) $22.95 
Paddle Controllers (Pair) . . . $9.95 

Rev. "C" Basic ROM $15.00 

Rambo XL w/o RAM IC's $39.95 
850 or PR Modem Cable . . $14.50 
850 or PR Printer Cable . . . $14.50 

Printer Interface $43.95 

I/O 13 Pin PC connector . . . $4.50 
I/O 13 Pin Cable end plug . . $4.50 

1027 INK ROLLER $6.50 

1030 Modem Power Pack . . $6.95 



CALL TOLL FREE 
1-800-551-9995 

IN CALIF. OR OUTSIDE U.S. 
CALL 415-352-3787 



CARTRIDGES 

For XL's/XE's 800/400 

POLE POSITION Cartridge $15.00 

STAR WARS - Return ol the Jedi . . $15,00 

PAC-MAN Cartridge $4,00 

DELUXE INVADERS Cartridge $4.00 

JOURNEY TO THE PLANETS Cart. $4.00 

GORF Cart. 800/400 Only $4.00 

DONKEY KONG Cartridge $5,00 

STAR RAIDERS Cartridge $5.00 

MILLIPEDE Cartridge $10,00 

PLATTER MANIA Cat. by Epyx . . $9.95 

WIZARD OF WOR Cartridge $9.95 

CAVERNS OF MARS Cartridge . . $14.50 

PENGO Cartridge $15.00 

EASTERN FRONT Cartridge $15.00 

ATARIWRITER Cartridge $29.95 

TURMOIL Cartridge $5,00 

CROSSFIRE Cartridge $7.50 

SPRINGER Cartridge $7.50 

ADVENTURE CREATOR Cartridge $12.50 

ZONE RANGER Cartridge $12.50 

SILICON WARRIOR Cartridge .... $12,50 
MATH ENCOUNTER Cartridge .. . $12.50 
BASIC LANGUAGE Cartridge . . . $15.00 
PILOT LANGUAGE PACKAGE , . , $17.50 

SPARTADOS-X Cartridge $59.95 

ACTION O.S.S Cartridge $59.95 

ACTION TOOL KIT DISK $25.00 

MAC-65 OSS. Cartridge .... $59 95 

MAC-65TOOL KIT DISK $25.00 

R-TIME 8 Cartridge $56.95 

SPINNAKER EDUCATIONAL CARTRIDGES 

KINDERCOMP Cartridge $8 75 

FRACTION FEVER Cartridge , . . $8.75 

FACEMAKER Cartridge $8.75 

ALPHABET ZOO Cartridge $8.75 

UP FOR GRABS Cartridge $8.75 

ALF IN THE COLOR CAVES Cart. $8.75 

DELTA DRAWING Cartridge $8 75 

STORY MACHINE 600/400 only $8.75 

LINKING LOGIC (Fisher-Price) Cart $8.75 

HOT DISK TITLES 

BEST SELLERS / LOW PRICES 

• GHOSTBUSTERS $9.95 

■ F-15 STRIKE EAGLE $14.95 

■ TOP GUNNER COLLECTION. .. $14.95 

• SILENT SERVICE $14.95 

• KENNEDY APPROACH $14.95 

•VIDEO TITLE SHOP (64K) $12,50 

■ CHESSMASTER 2000 $12 50 

• ALTERNATE REAUTY THE CrTY $12.50 

• ALTERNATE REAUTY DUNGEON $12.50 

• TOMAHAWK (64K) $12.50 

•221-B BAKER STREET (S4K) $12.50 

• MUSIC STUDIO $12.50 

• • • • INFOCOM ADVENTURES 

• WISHBRINGER $14.95 

• MOONMIST $14.95 

• SPELLBREAKER $14.95 

• SEA STALKER $14.95 

• HOLLYWOOD HIJINX $14.95 

• STATION FALL $14.95 

• INFIDEL $14.95 

• LURKING HORROR $14 95 

• CUT THROATS $14.95 

• BALLYHOO $14.95 

• SUSPENDED $14.95 

•WITNESS $14.95 

• HITCH HIKERS GUIDE $14.95 

• ZORK 1 « ZORK 2 $14.95 EA. 



COMPUTER BOOKS 

ATARI PLAYGROUND WORKBOOK $5.95 
HACKERBOOK TRICKS* TIPS... $5.00 

INSIDE ATARI BASIC $5.00 

ATARI BASIC REF. MANUAL $5.00 

HOW TO ATARI 6502 PROGRAM , $5.00 

WRITE YOUR OWN GAMES $5.00 

PROGRAMMERS REF. GUIDE .... $14.95 
ASSEMBLY LANGUAGE GUIDE . . $21.95 

XE USERS HANDBOOK $21.95 

XL USERS HANDBOOK $21.95 

ATARI BASIC FASTER S BETTER $22.95 
YOUR ATARI COMPUTER $17.95 

SERIAL I/O CABLE 

High Quality, 13Pin $4.50 

Special ... 3 Cables for $10.00 

MAC-65 CARTRIDGE 

6502 Machine language Macro- 
Assembler. First class tool for 
serious programmers. . . $59.95 

PR: CONNECTION 

Serial/Parallel Interface for connecting 
modems and printers $65.00 

SUPRA MODEM 

Supra 300 Baud Direct Connect 
Modem requires no separate 
interface. Includes cable and Disk 
Software. Supports X-Modem, 
Download & Upload $29.95 



nDisks-XL's/XE^80Cr 

| F-15STRIKE EAGLE Disk $14.95 

I TOP GUNNER COLLECTION. $14.95 

I SILENTSERVICE Disk $14.95 

I KENNEDY APPROACH Disk $14 95 

NATO COMMANDER Disk $14.95 

I S.A.T. MATH $17 95 

S.A.T, VERBAL $17 95 

I VISICALC Spreadsheet $19.95 

BOOKKEEPER 5 CX85 KEYPAD . $19.95 

SPIDER MAN Disk $4 95 

I DAVID'S MIDNIGHT MAGIC Disk $4.95 

I ALIEN AMBUSH Disk $4.95 

] REAR GUARD Disk $4 95 

I TECHNA-COLOR DREAM Disk . , , $4.95 

I FREAKY FACTORY Disk $4.95 

I LASER HAWK Disk $4.95 

I ROCKET REPAIRMAN Disk $4.95 

HUMAN TORCH 8 THE THING.. . $5.00 

MUSICAL PILOT Ed. Disk $5.00 

COMPUTATION Disk $5.00 

I MASTER CHESS Disk $5 00 

SPEED KING Disk $5.00 

LAST V-8 Disk $5.00 

PATHFINDER Disk $5 00 

I MATCH RACER Disk $5.00 

I WOMBATS 1 Adventure Disk .... $5.00 
] FAMILY FINANCE Disk by Alari . . $6.50 

I FORT APOCALYPSE Disk $7.50 

| NINJA Disk $7 50 

I ELECTRA-GUDE Disk $7.50 

I SPORTS SPECTACULAR Disk... $7.50 

I THE GAMBLER Disk $7.50 

I STRATOS Disk $7.50 

I MIND MAZES {Educational) $7.50 

TIMEWISE $7.50 

I VIDEO VEGAS Poker & Slots $9 95 

ACTION BIKER $9.95 

I KICK START $9.95 

I MONEY TOOLS (Financial Utility). . $9.95 

I DIG DUG Disk 59.95 

REPTON Disk $9.95 

I PUZZLE PANIC Disk by Epyx $9.95 

I CEST'E LA VE Disk $9.95 

I WOMPER STOMPER Disk $9.95 

I OUN EMERALD (Jr.. Adv.) $9.95 

I MOVIE MAKER (Graphics) $9.95 

I FINANCIAL COOKBOOK $9 95 

I CYCLE KNIGHT $9.95 

I SONG WRITER $9.95 

I COUNTINGS ADDING wthTink .. $9.95 

I CHESSMASTER 2000 $12.50 

I BRIDGE 4.0 $12.50 

PEGAMMON $12.50 

MUSIC STUDIO $12.50 

HOTEL ALIEN $12.50 

I FOOBLIKSKY Disk / Board Game $12.50 

GHOST CHASER $12.50 

I L A SWAT $12 50 

GRANDMA'S HOUSE"(EducarJonal') $12^50 

I DROPZONE Disk $12,50 

I CASTLE WOLFENSTEIN Disk. .. $12.50 
I BEYOND CASTLE WOLFENSTEIN $12.50 

I TEMPLE OF APSHAI $12.50 

I ALI-ANTS Disk $12.50 

I MOUSE QUEST Disk (64K) $12.50 

I ELECTRONIC DRUMMER Disk . . S12.50 

STOCK MARKET Game $12.50 

I PIRATES OFTHEBAR8ARYCOAST$12.5Q 

NICKERBOCKER Disk $12.50 

MIDWAY BATTLES War Game. . $12.50 
I BOULDER DASH Construction Set $14.95 
I MIND SHADOW Adventure 64K . . $14.95 

I HACKER Adventure $14.9 

SEA STALKERAdventure $14.95 

CONFLICT IN VIETNAM $14.95 

I DECISION IN THE DESERT $14.95 

I CRUSADE IN EUROPE $14.95 

I SPITFIRE ACE $14.95 

SSI 50 MISSION CRUSH $14,95 

I SSI BATTALION COMMANDER . . $14.95 

I SSI PANZER GRENADIER $14.95 

I SS! FIELD OF FIRE $14.95 

I SSI GEMSTONE WARRIOR $14.95 

I MASTERTYPE (Typing Tutor) . , , $15.00 

I BANK STREET WRITER $17.50 

I CUT 8. PASTE W.P. Disk $17.50 

I SPARTADOS CONST. SET .... $39.50 

I SPARTADOS Tool-Kit $32.95 

I UK DATA PERFECT Database . . . $CALL 

DATASOFT DISKS 

I VIDEO TITLE SHOP $12.50 

VIDEO TITLE SHOP Companion 2 $7.50 

ALTERNATE REALITY (The City) $12.50 

I ALTERNATE REAUTYThe Dungeon $12.50 

I ZORRO Disk $9.95 

I SARACEN Disk $9.95 

I CROSSCHECK Disk $9.95 

I GUNSLINGER Disk (64K) $9.95 

I TOMAHAWK Helicopter Game 64K $12.50 
THEATER EUROPE War Game, . $12.50 

BRUCE LEE Disk $12.50 

I MERCENARY Disk $12.50 

MERCENARY 2ND CITY DISK . . $12.50 

I THE GOONIES Disk $12,50 

I CONAN Disk $12.50 

NEVER ENDING STORY (54K) . . $12 50 

221-B BAKER STREET (64K) ... $12 50 

I 221-B BAKER ST. Case Library 1 $9 95 

I 221-B BAKER ST. Case Library 2 $9.95 

I Napolean in Rusaa (Borodino 1812) $12.50 

3ISMARCK $12 50 

IMOON SHUTTLE $12 50,, 



AMERICAN TECHNA-VISION 

I Mail Order: 15338 Inverness St., San Leandro, Ca. 94579 
Sales Office: 2098 Pike Ave., San Leandro, Ca. 94577 

Terms: NO MINIMUM ORDER. We accept money orders, personal checks or 
C.O.D.s. VISA, Master/Card okay. Credit cards restricted to orders over $18.50. No 
personal checks on C.O.D. - Shipping: $4.00 shipping and handling on orders under 
$150.00. Add $2.75 for C.O.D. orders. In Canada total $6.00 for shipping and 
handling. Foreign shipping extra. Calif, residents include 7% sales tax. All products 
| new and guaranteed. All sales final.. 

s subject to change without notice Send SASE lor free price list Atari is a reg trademark ol Atari Corp 
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As promised, this month we'll take a look 
at a simple but complete program in order 
to review, as well as to apply, much of what 
we've learned over the last few installments 
of BASIC Training. We'll also cover some 
new material; specifically, simple disk- 
access techniques and basic error-trapping. 

Before we continue, you should type List- 
ing 1, using BASIC Editor II to validate your 
work. Once you have the program typed 
properly, save it to disk. 

Using the Program 

Listing 1 is a simple address-book pro- 
gram that you can use to store addresses and 
phone numbers on disk. Run the program 
and press "C." You'll be asked for a file- 
name. Type the filename, including the de- 
vice (i.e.,D:), and press Return. Now follow 
the prompts and enter as many addresses 
as you like. (Make sure you leave the disk 
in the drive.) To get back to the menu, type 
Return at one of the prompts. 

After you've created your file, you can 
add more addresses by using the Load op- 
tion. Press "L", then type in the filename. 
Enter whatever addresses you want and then 
press Return at any prompt to get back to 
the menu. 

To see the addresses stored on the disk, 
press "V." You'll need to type the filename 
again, after which the addresses will be read 
in from the disk and displayed, four at a 
time, on the screen. Keep pressing Return 
until you've seen all the addresses. 

Finally, to exit the program and return to 
BASIC'S READY prompt, press "Q" and 
Return. 

How it Works 

Now that you're familiar with what the 
program does, let's see what makes it tick. 
(Do computers tick?) 



Lines 10-90 do nothing but identify the 
program. All of your programs should have 
a series of remarks like this at the be- 
ginning. 

Line 100 dimensions the string variables 
we'll be using in the program. 

Lines 110-150 are more remarks. 

A block of remarks is useful in partition- 
ing sections of your program so you can 
more quickly find a particular portion of 
code. Remarks also help you remember 
what the program is doing. Every program 
can be broken up into a series of smaller 
tasks, just as we've done here. Always com- 
ment your programs; you'll be glad you did. 

Line 160 clears the screen. (Never mind 
how it does it for the time being.) 

Lines 170-250 print the menu to the 
screen. 

See the question mark at the beginning 
of each line? That's Atari BASIC'S abbrevi- 
ation for the PRINT command. Also no- 
tice how a series of print statements lined 
up like this shows exactly what will appear 
on the screen. 

Line 260 retrieves a menu selection from 
the user. 

Lines 270-300 examine the user's input 
and route the program execution to the ap- 
propriate section of code. 

Notice that, in this IF. . .THEN state- 
ment, we've used the word OR. If either of 
the expressions separated by the OR is true, 
the IF evaluates to true, and the THEN por- 
tion is executed. If both of the expressions 
are false, the IF evaluates to false, and pro- 
gram execution drops down to the next line, 
ignoring the THEN portion. 

The opposite of OR is AND. When two 
expressions are separated by AND in an IF 
statement, both of them must be true in or- 
der for the IF statement to be true. 

Confused? Let's look at this in more de- 



tail. The following shows what would hap- 
pen if the user typed an "L" in response 
to our menu: 

Line 270: Is the letter that was typed a 
"C" or a "c"? No. Drop down to the next 
line. 

Line 280: Is the letter an "L" or an "V '? 
Yes! The THEN portion of the statement is 
performed, causing the program to jump to 
line 450. (Notice that we don't need a 
GOTO after a THEN.) 

Now let's see what happens when the user 
types the letter "H," a response not listed 
in our menu: 

Line 270: Is the letter a "C" or a "c"? 
No. Drop down to next line. 

Line 280: Is the letter an "U'oran "I"? 
No. Drop down to the next line. 

Line 290: Is the letter a "Q" or a "q"? 
No. Drop down to the next line. 

Line 300: Is the letter a "V" or a "v"? 
No. Drop down to the next line. 

Line 310: None of the letters matched, so 
it 's back up to Line 260 to get a new input. 

You should have learned two things here. 
First, whenever you ask a user to type 
something in, you should check for both up- 
percase and lowercase responses. "C" and 
"c" are as different to the computer as "A" 
and "Z." But, because people tend to think 
of lowercase and uppercase as being the 
same, we should let them type a response 
either way. 

You should have also noticed that if the 
user doesn't type one of the choices from 
the menu, we make him try again. "Error 
trapping" is an important part of writing 
user-friendly software. Unfortunately, due 
to space and time limitations, our program 
in Listing 1 is loaded with pitfalls for the 
user, places where the program may bomb 
due to incorrect input. (Try typing a file- 
name without the device, for example.) But 
our menu is not one of them. 

Line 370 gets the filename of the file the 
user wants to open. 

Line 380 opens the requested file for 
output. 

OPEN allows us to access files in a num- 
ber of ways, and, as you can see, it has four 
parameters. The first parameter, preceded 
by the pound sign (#), is the channel we 
want to use as the data stream for our file. 
We may use any channel from one to sev- 
en. Once a file has been open, we use the 
channel number to refer to it, rather than 
the filename. The second parameter is a 
code that tells BASIC the type of operations 
we want to perform on the file. There are 
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five possible values: 
4 - open for input only 
6 - open for directory 

8 - open for output only 

9 - open for append 

12 - open for input and output 

When a file is opened with a 4, we may 
read data from the file, but we may not 
change the file in any way. When opened 
with a 6, we can read the disk's directory 
(a special file that contains the names of all 
the files on the disk). When opened with 
code 8, the file, if it doesn't already exist, 
is created on the disk, or, if it does exist, 
it is erased and restarted. After it is opened 
with code 8, a file may only have data writ- 
ten to it; we cannot read from the file. When 
opened with a 9, the file pointer, which 
marks where on the disk the next data will 
be written, is moved to the end of the file, 
where we may add more data. A file opened 
with code 12 can be used for both input and 
output operations. 

This month we're concerned only with 
codes 4, 8 and 9. We'll cover the others 
eventually, but they're too complicated for 
this discussion, particularly code 12, which 
is used for random-access files and would 
require an entire article to explain 
thoroughly. 

The fourth parameter in the OPEN com- 
mand is the complete filename of the file 
to open. By complete, I mean that the de- 
vice (D :, C :, D2 :, etc. ) must also be includ- 
ed. The filename may be stored in a string 
variable, as we've done in Line 380, or it 
may be a string literal, like this: 




8 



^it 



After you've 



CREATED YOUR 
FILE, YOU CAN 

ADD MORE 
ADDRESSES BY 

USING THE 
LOAD OPTION. 





user and open that file for append. 

After the file is opened, any addresses 
typed will be added to the end of the file, 
without changing any of the addresses that 
were already stored there. 

Lines 520-550 get an address from the 
user. 

In order to allow the user to get back to 
the menu, we're using a statement like this: 




Notice that when you use a string literal 
for a filename, it must, just like any other 
string literal, be enclosed in quotes. 

So, Line 380 opens a file for output. Be 
careful, though. This section of the program 
really should have some safeguards built in. 
If the user requests a file that already ex- 
ists, it will be erased from the disk without 
any warning. In a complete program, we'd 
first check to see if the file already existed 
and, if it did, warn the user, giving him a 
chance to change his mind. 

Line 310 sends program execution to the 
section of code that retrieves the addresses 
from the user. 

Lines 450-460 get a filename from the 



As you can see, there's nothing between 
the quotes. In English, we're saying "If 
NAMES is empty, go to Line 620." A string 
will be empty if the user presses Return at 
the prompt without typing anything. 

Line 560 prints to the screen the address 
just entered. 

Line 570 asks the user if the information 
to a complete halt) whenever they encoun- 
tered runtime errors. With a TRAP, how- 
ever, we can grab an error before the user 
is ever aware of it and decide how to han- 
dle it ourselves. 

The TRAP statement has only one pa- 
rameter: the line number to which you want 
program execution to jump whenever an er- 



ror is encountered. In Line 700, we're tell- 
ing the computer to jump to Line 760. 

Line 710 sets our address counter, 
COUNT, to zero and clears the screen. 

We need to count the addresses displayed 
because we can fit only four addresses on 
the screen. After four addresses have been 
displayed, we want to stop and wait for the 
user to request more. If we didn't do this, 
the addresses at the top would scroll off as 
we added more at the bottom. 

Line 720 reads an address from the disk 
file. 

Just as with PRINT, the INPUT com- 
mands here work the same as the INPUT 
we've used to retrieve information from the 
screen (or from the keyboard, depending on 
how you look at it), the only difference be- 
ing the pound sign and channel number. 
(Notice that we INPUT the addresses in ex- 
actly the same way that we PRINTed them.) 

Line 730 prints to the screen the strings 
we retrieved from the file. 

Line 740 increments our counter. If 
COUNT equals 4, we ask the user to press 
Return when he's ready to see more, after 
which we go back to the section of code be- 
ginning at Line 710, where we set COUNT 
back to and get the next address. 

(CONTINUED ON PAGE 127J 
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Using Dialog Boxes with GFA Basic 3.0 



You've all seen dialog boxes in pro- 
grams; they are GEM's "window on 
the world." The purpose of dialog 
boxes is to obtain information from 
the user. The file-selector box is one 
example. There are, of course, other 
ways to do this, but none so elegant 
as using a dialog box. They can con- 
tain buttons, text, editable fields, pic- 
tures, sliders and other elements to 
provide both information and or- 
namentation. 

Unfortunately, it has been difficult 
for the average programmer to include 
dialog boxes in his or her program. 
It's not because dialog boxes are hard 
to build. There are a number of easy- 
to-use RCSs (Resource Construction 
Sets) that make building dialog box- 
es a matter of point-and-click. It's also 
not because it's hard to actually put 
the dialog box up on the screen. Just 
a few simple commands will load and 
draw the box. No, the problem has 
not been in getting a dialog box on 
the screen, but in getting the user- 
entered information back once he ex- 
its the box. How does the program get 
at that information? 

The release of GFA BASIC 3.0 has 
considerably simplified the task of 
working with dialog boxes by provid- 
ing a variety of commands that make 
it easier to retrieve the information. 
It's still not a trivial matter, but it's 
now much more straightforward. The 
purpose of this article (and the one to 
follow next issue) is to teach you what 
you need to know to build a dialog 
box and retrieve the information the 
user provides. When we get done, you 
should be able to build and use your 
own dialog boxes, making your GFA 
BASIC programs look more profes- 
sional. 

TYPES OF DIALOG 
BOX OBJECTS 

The first thing to understand is that 
there are many types of objects that 
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can be used in dialog boxes. This 
should come as no surprise if you've 
seen some of the complex boxes that 
accompany commercial programs. 
The main types of objects that can be 
used in a dialog box are: 

1. G_BOX: This is a rectangular 
box with adjustable parameters. 
Among these are its size, color, bor- 
der thickness and fill pattern. 

2. G_IBOX: This is a rectangular 

box identical to G BOX, except that 

it can't have a fill pattern. The inside 
of the box is "F'nvisible. 

3. G_BOXCHAR: This rectangu- 
lar box is identical to G BOX except 

that it can contain a single character. 
The character can have its color and 
size adjusted. 

4. G_BUTTON: This is a box 
containing text that is always centered. 
The size of the box is adjustable. 

5. G_STRING: A character 
string. 

6. G_TEXT: Graphic text. The 
font size and text color can be varied, 
as can the writing mode (replace, 
transparent, etc.). 

7. G_BOXTEXT: This is graphic 
text with a box around the text. In ad- 
dition to the G TEXT variations, 




you can set the border width and ( 
or, fill pattern and color and the align- 
ment of the text in the box. 

8. G_FTEXT: This is the type of 
field used for editable text. It has three 
components. The first is the template 
field. Anything you enter here will be 
duplicated in the dialog box. For ex- 
ample, you could enter "Name: " in 
this field, and it will appear at the left 
side of this field in the dialog box. You 
could also enter something like 

"Date: / / ." When the 

user actually goes to enter the date us- 
ing the dialog box, the slashes would 
be automatically skipped as he or she 
types in the numbers. 

The RCS that comes with GFA BA- 
SIC 3.0 seems to need placeholders 
to reserve the number of spaces you 
want to use for data entry. The sym- 
bol for the placeholder is the tilde (~). 
Everywhere you enter this symbol, an 
underline ( ) will appear in the dia- 
log box. Thus, the date example 
would actually have to be entered as 
"Date:~ /~ /"." 

The next field is the validation 
field. Here you specify what charac- 
ters are acceptable. You must enter 
one character for each placeholder. 
The validation characters are: 

9 — accept only numeric charac- 
ters 0-9. 
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A — accept only uppercase alphabetical 
characters. 

a — accept only upper or lowercase al- 
phabetical characters. 

N — accept uppercase alphabetical 
characters or numbers. 

n — accept upper/lowercase alphabetical 
characters or numbers. 

F — accept any character that can be part 
of a valid GEMDOS filename. 

P — accept any character that can be part 
of a valid GEMDOS pathname. 

p — same as P, except that wildcard 
characters (*,?) will not be accepted. 

X — accept any character. 

The last of the three components is the 
initial text field. Here you enter any string 
you want (usually a default) in the text field 
when it appears on the screen. You may en- 
ter blanks if you like, but you must enter 
as many characters as there are placeholders 
in the Template string. The color, size and 
writing mode of the text can be set. 

9. G_FBOXTEXT: This is identical to 

G FTEXT, except it has a border around 

it. The thickness and color of the border can 
be set. A fill pattern can be selected as well 
(along with its color), but the fill pattern 
will be visible only in the portion of the box 
not fillable by text. That is, if the border 
of the box is sized to fit exactly around the 
maximum-size string it can contain, then 
the fill pattern will never be visible. 

10. G_ICON: This is a graphic. A vari- 
ety of icon editors is available for design- 
ing your own icons. If you make the icon 
selectable (see States) and you want it to 
change color when you do select it with 
your mouse, you must design a mask when 
using the icon editor. Icons can be selecta- 
ble, just like buttons, and thus can serve as 
fancy graphic buttons. 

NEW COMMANDS 
IN GFA BASIC 

One of the things that makes working 
with dialog boxes easier is the addition of 
new commands to Version 3 of GFA BA- 
SIC. Previously, when you wanted to use 
the AES commands that accessed dialog 
box fields, you needed to construct a code 
that POKEd in values, make a call to AES, 
and then jump through a series of memory 
addresses to get to where the data was ac- 
tually stored. Commands to modify the di- 
alog box were nearly as complicated. 

With GFA BASIC 3.0, however, these 
complex lines of code have, in large part, 
been replaced with a single command. 
While it is outside the scope of this article 
to detail each command and its parameters 
(that's what you have the manual for, though 



heaven knows its the very worst manual I've 
ever seen . . . ) , a brief summary of the more 
useful commands is in order so that you can 
follow along more easily: 

1. RSRC_JLOAD (filename) attempts to 
load your resource file (given by filename) 
from disk. The resource file can contain 
many types of resources, such as menus, 
alert boxes and dialog boxes. In this arti- 
cle, however, we are going to concentrate 
on dialog boxes. If the resource load is suc- 
cessful, this function returns a nonzero val- 
ue. If it fails for any reason (i.e. the resource 
file is not available), it returns a zero. 

2. ~RSRC_GADDR(0,treenumber,adr%) 
returns the address of a tree in memory. All 
resource structures, such as our dialog box, 
are identified by their tree. The address of 
the tree is important, as this number will 
be used in almost every call to a dialog-box 
function. The address is stored in the third 
parameter, adr%. The second parameter 
determines which tree to return the address 
of. If you have only one tree, treenumber 
would be zero. The first parameter can have 
other values besides zero, but again, ex- 
plaining all the parameters is beyond the 
scope of this article. 

3. TORM_CENTER (adr % ,x % ,y % ,w % , 
h %) calculates the x, y, width and height 
coordinates of the dialog box with address 
adr% when it is located in the center of the 
screen, and places these values in the oth- 
er parameters. While you don't have to put 
your dialog box in the center of the screen, 
that is where you most often want it located. 

4 . ~FORM DIAL (flag , minx,miny, minw, 

minh,maxx,maxy,maxw,maxh) has a variety 
of functions, depending on the value of the 
parameter flag. However, the two most 
common are to create an expanding rectan- 
gle (used before drawing the dialog box, 
flag = 1) or a shrinking rectangle (used af- 
ter you are through working with the dia- 
log box and are ready to remove it from the 
screen, flag = 2). While these two effects 
are strictly cosmetic, they do give that 
"professional" look. Parameters 2-5 specify 
the minimum x, y, width and height of the 
expanding or shrinking rectangle, while the 
rest of the parameters specify the maximum 
values. Typically, the minimum value is 
zero, while the maximum values would cor- 
respond to the values returned by 
FORM_CENTER. 

5. ~OBJC_DRAW(adr% .start, end,x% , 
y%,w%,h%) actually draws the dialog box 
given by adr% on the screen. Start speci- 
fies the starting level at which to begin 
drawing (0 if you are drawing the whole di- 
alog box), while end specifies how many 
levels should be drawn (do not specify more 



I 

than seven). The concept of levels is not 
hard to understand graphically. The dialog 
box itself is at level 0. Any object contained 
in the dialog box is at level 1. Any object 
contained by a level-1 object is a level-2 ob- 
ject, and so on. It is important to note that 
this command does not activate the box for 
user input. This command can also be used 
to redraw only parts of the dialog box. 

6.TORM_DO(adr%fieldnumber) turns 
control of the dialog box specified by adr % 
over to GEM so the user may interact with 
it: click on buttons, type in text, etc. This 
function returns the value of the object the 
user clicked on to exit the dialog box. GEM 
relinquishes control of the dialog box when 
you click on an "exit" button (see the next 
section). An example of an exit button is 
the button labeled "OK" in the file-selector 
box. It's important to note that, although 
GEM releases control of the dialog box, it 
does not erase it from the screen. It is up 
to the programmer to restore whatever was 
behind the dialog box. The parameter field- 
number specifies which field the cursor 
should start in and is usually set to zero. 

7. ~OBJC_CHANGE(adr % ,objnum,0, 
x%,y%,w%,h%, state flag) changes the state 
of the object given by objnum in the dialog 
box specified by adr%, usually an exit but- 
ton. We'll talk more about "states" in the 
next section; however, an example of this 
would be when you click on the OK but- 
ton, and it turns dark just prior to the dia- 
log box disappearing from the screen. 
When the OK button turns dark, it is in its 
"selected" state. If you didn't use the 
OBJC_CHANGE command to return it to 
its "unselected" state, the OK button would 
still be dark the next time you activated the 
dialog box. 

The parameter state gives the state that 
the object is to be changed to, and flag de- 
termines whether the object should be 
redrawn right away (1) or not (0). If the di- 
alog box has been removed from the screen, 
there is no need to immediately redraw the 
object, because it will be redrawn the next 
time the dialog box is drawn on the screen 

with ~OBJC DRAW. However, if you are 

immediately reentering FORM DO to re- 
use the dialog box without using 
*OBJC^DRAW, then you should specify 
flag to be 1 to redraw the changed object. 

8. OB_STATE(adr%, obj) returns the 
state of the object given by obj. States are 
described in the next section. 

9. OB_SPEC(adr%,obj) returns the ad- 
dress of information about the object speci- 
fied by obj. This is primarily of interest 
with buttons, text and editable fields, where 

(CONTINUED ON PAGE 130) 
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FEATURE 



(CONTINUED FROM PAGE 106; 

7720 UUO JSR GETTOKN jget line 
7730 STA LINEHO jnunber 



JSR GETTOKN 
STA LINENO+1 
CMP a$80 
BCC UU1 
JSR DOCR 
JMP LSBEG 



;at 32768? 
;no 

jyes try 
jnext variable 



7748 

7758 

7768 

7778 

7788 

7790 

7888 

7818 UU1 JSR GETTOKN JOffset 

7828 UNI JSR GETTOKN ;offset 

7838 JSR GETTOKN ;token 

7848 CMP 8$02 ;peM /data 

7858 BCS UU2 

7868 UU3 JSR GETTOKN ;get byte 

7878 CMP »EOL JEOL yet 

7888 BNE UU3 jkeep going 

7898 BEQ UUO ;next line 

7988 ;look for end of statenent 

7918 jor line 

7928 UU2 JSR GETTOKN 



jstatnt end? 
j next stnt 
;THEN? 

;line end? 
;next line 
;nuM constant? 
;try string 
jskip nunber 



7938 CMP 8$14 

7948 BEQ UNI 

7958 CMP 8$1B 

7968 BEQ UNI 

7970 CMP 8$16 

7980 BEQ V\>0 

7998 CMP 8$8E 

8880 BNE UU4 

8010 LDX tt$06 

8820 UU7 JSR GETTOKN jpull nunbr 

8030 DEX 

8040 BNE UU7 

8050 BEQ UU2 

8060 UU4 CMP 8$8F J a string? 

8878 BNE UU6 ; no 

8888 JSR GETTOKN ; length 

8898 TAX ;skip it 

8188 BNE UU7 

8118 UU6 CMP MYTOKEN ;a variable? 



8120 BNE UU2 

8130 LDA LINENO 

8140 STA FRO 

8158 LDA LINENO+1 

8168 STA FR8+1 

8178 JSR IFP 

8188 JSR FASC 

8190 INC PRFLAG 

8200 LDA PRFLAG 

8210 CMP 86 

8220 BNE UP2 

8230 LDA 80 

8248 STA PRFLAG 

8258 JSR DOCR 
8260 UP2 JSR MPRINT 
8270 UP4 LDA 8$28 



; nope 

jshow line 
jnunber 



;INT to FP 

JATASCII 

;screen 

; fornat 

;5 per screen 

; line 



; reset 

jroll presses 
jspace 

; f ornat with 
jspaces so 
; in colunns 
Jtry More lines 



8280 JSR PUTC 

8290 INV 

8388 CPY 86 

8318 BNE UP4 

8328 JMP UU2 

8338 ; 

8340 ;get a token and increment 

8358 ;the pointer in BASIC 

8368 J 

8378 GETTOKN LDY 8$00 

8380 LDA CL0),Y 

8390 INC LO 

8400 BNE NINC 

8410 INC LO+1 

8420 NINC RTS 

8430 ; 

8440 .INCLUDE 8D:BUPP2.M65 

8450 ; 

8460 ;data 

8470 j 

8480 ERMES .BYTE " 8 RORRE" 

8490 BB1 .BYTE $9B, "egakcaP seiti" 

8500 .BYTE "litU CI5AB",$7D 

8510 NDLIST .BYTE $70, $70, $42 ; new 

8520 .WORD TLINE ;disply list 

8530 .BYTE $01 

8540 BACK .WORD $00 ;disp.lst fig 

8550 TLINE .SBYTE " EXECUTI" 

8560 .SBYTE "ING LINE: " 

8570 .SBYTE " 



8580 ONOFF .BYTE 



8598 TFLG *= 
8688 DLS K= 
8618 DLH K= 
8620 BCD K= 
8630 BFR8 *= 
8648 BFR1 *= 
8658 YSAU K= 
8668 XSAU *= 
8678 PYSAU *: 
8688 Yl *= 



K+l 
K+l 
K+l 
K+4 
K+l 
«+l 
K+l 
K+l 

K+l 
K+l 



;auto nun fig 

jtrace fig 
jsave old 
;disp. list 
;bcd wrk area 
jpsuedo FP 
;registers 
;save y,x 

jsave y 
jMore save 



_8 



8698 
8788 
8718 
8728 
8738 
8748 
8758 
8768 
8778 
8780 
8790 
8888 
8818 
8820 
8830 
8848 
8858 
8868 
8878 
8888 
8898 
8900 
8918 
8928 
8938 
8948 
8958 
8968 
8978 
8980 
8998 
9888 
9018 
9020 
9030 
9040 



XI K= K+l 
Y2 K= K+l 
X2 K= K+l 
CY1 K= K+l 
QTFLAG K= K+l 



;x and y 



,-ysave in end 
jquit nun fig 



TOKTAB .BYTE 10,11,12,13,35,4 
OFFSET K= K+l ;ren-stnt offst 



NXTSTM K= K+l 

PRFLAG K= K+l 

LSTKEY K= K+l 

MYTOKEN K= K+l 

X3 K= K+l 

DONMES .BYTE EOL, "derebnuner 

.BYTE "nargorP" 
OURMES .BYTE $9B, "86723 => eniL 1 
READ .BYTE EOL, "YDAER" 



;next St. offst 
;print fig 
j last key 
jsave ny token 
;save x 



0600 LI LDA 0VRMES,X ;over the 
0610 JSR PUTC ;Max 
0620 DEX 
0638 BPL LI 

8648 JMP EXIT2 ;to BASIC 
0650 ; 

0660 GETPTR LDA STMTAB ; point to 
8678 STA LINPTR JBASIC'S 
8680 LDA STMTAB+1 ; first line 
0698 STA LINPTR+1 
0788 RTS 
0710 ; 

0720 FLNCLN LDA FLINE ;put new 
STA CLINE 



TIMER K= K+l 
ENDLIN K= K+l 



K+l 
K+2 



;vbi tinei — nun 
;end line-nun 
jchar. enter 
;save vvblkd 
BYTE E0L,"rorre eulaU" 
.BYTE ' , B123456789ABCDEF ,, 
; crunch 

;ed. vector tab 
; for directry 
K.K",EOL 
J8 buffers-nun 
;& ren 
; f or unify 



CHRCNT 
UBLKDS 
FPMES 
HEXTAB 

ENDPTR K= K+l 
MYEDIT K= K+16 
DIRBUF K= K+28 
DIRNAM .BYTE "D 
NBUF K= K+8 
N2BUF te K+29 
.BYTE 8 



.OPT LIST 
ENDPRG *- K+l 

.OPT NO LIST 
K= SB2E2 

.WORD INI 
.END 



Listing 3: 
Assembly 



0108 

0110 

0120 

0130 

0140 

8150 

0160 

0170 

0188 

0190 

0208 

8210 

0220 

0238 

0240 

8250 

0260 

0270 

8280 

0298 

8388 

8310 

0328 

8338 

0340 

0358 

0360 

0370 

0380 

0390 

0400 

0410 

0420 

0430 

0440 

0450 

0460 

0470 

0480 

0490 

0500 

0510 

0520 

8530 

0540 

0550 

0560 

0570 

0580 

0598 



:SAUE8D:BUPP2.M65 



BUP.SYS part II 

CO 1989 
by Barry Kolbe 



;get line nunbers 



RENUM JSR GETNBR 
JSR DOCR 



LDX 83 

5TX PRFLAG 



;set prflag 



jcheck if line>32768 



;point to 
; first line 
jcheck hi byte 
, Y jof line 8 
j>=32768? 
;yes-A0K 
;will new line 
;be >32768? 
; yes-quit 
;add increnent 
jto current 
;new line 



JSR GETPTR 
CLD 
NXTLN1 LDY 81 

LDA CLINPTR) 

CMP 8$80 

BCS LINOK 

LDA CLINE+1 

CMP 8$80 

BCS LINOUR 

LDA CLINE 

CLC 

ADC ILINE 

STA CLINE 

LDA CLINE+1 

ADC ILINE+1 

STA CLINE+1 

INY ;add offset 

LDA CLINPTR), Y ;tO BASIC 

CLC jcurrent line 

ADC LINPTR 

STA LINPTR 

LDA LINPTR+1 

ADC 88 

STA LINPTR+1 

JMP NXTLN1 



jcheck nore 



;first line 
LDA FLINE+l JintO 
STA CLINE+1 ;test line 
RTS 



jrenunbered lines will all 
;be less than 32768 



8730 

0748 

8758 

0760 

0770 

0780 

0790 

0800 

0810 LINOK JSR GETPTR jreset pntrs 

0820 JSR FLNCLN ;get first line 

0830 CKTOK LDY 80 Jget low byte 

0840 LDA CLINPTR), Y jof line no. 

0850 STA LINENO jsave it 

0860 INY 

0870 LDA CLINPTR), Y jnowhigh 

0880 STA LINENO+1 j byte 

0890 CMP 8$80 ; done' 

0300 BCC L2 ;no 

0910 JMP DOREN j do renunber' 

0920 L2 INY 

0930 LDA CLINPTR), Y JOffset to 

STA OFFSET jnext line 
INY joffset to 
LDA CLINPTR), Y j next stnt 
STA NXTSTM 
INY 

LDA CLINPTR), Y jget token 
LDX 85 J is it a 
CMP TOKTAB, X jspecial? 
BNE L5 



j yes-process 
j try next 

;IF token 

jhandle it 
jon token 
j do next stnt 
jhandle ON 



8948 

0950 

8968 

0970 

8980 L4 

0990 

1880 

1010 L3 

1020 

1030 JMP T0K1 

1040 L5 DEX 

1050 BPL L3 

1060 CMP 87 

1070 BNE L7 

1080 JMP T0K3 

1090 L7 CMP 830 

1188 BNE GTNXST 

1118 JMP T0K2 

1120 J 

1130 jget next stnt or line 

1140 j 

1150 GTNXST LDA NXTSTM J is nxt Stnt 

1160 CMP OFFSET ;= to next line? 

1178 BEQ NXTLN3 jwes 

1188 TAY j no 

1198 LDA CLINPTR), Y jget Offset 

1288 STA NXTSTM 

1218 JMP L4 j look for token 

1228 NXTLN3 CLC j Move to next 

LDA OFFSET j line 

ADC LINPTR 

STA LINPTR 

LDA LINPTR+1 

ADC 88 

STA LINPTR+1 

CLC jnove UP 

LDA CLINE jnew line 

ADC ILINE 

STA CLINE 

LDA CLINE+1 

ADC ILINE+1 

STA CLINE+1 

JMP CKTOK 



I 



jcounter 



1238 
1248 
1258 
1260 
1278 
1288 
1290 
1308 
1318 
1328 
1338 
1348 
1358 
1368 
1378 
1388 j do the renunbering 

1390 J 

1400 DOREN JSR GETPTR J pt to 1st line 

1418 JSR FLNCLN j new nnbrs 
1428 D0R2 LDY 81 Jhigh byte of 
1438 LDA CLINPTR), Y J line no 
1448 CMP 8$88 J at 32768? 
1458 BNE DOR1 jno 
1468 LDX 818 j yes-say 'done 1 
1478 DORT LDA DONMES, X 
1480 JSR PUTC 



jdo next line 



DEX 

BPL DORT 

JMP EXIT2 



line >32768 



linovr LDX 813 jshow error 



1490 

1508 

1518 

1528 J 

1538 D0R1 DEY 

1540 LDA FLINE 

1550 

1560 

1570 



Jto BASIC 

Jback up 1 byte 
jget new line 



STA CLINPTR), Y jnufibr 
LDA FLINE+l jand insert 
INY jit into 
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by Frank Cohen 





"The Tao gave birth to machine lan- 
guage. Machine language gave birth to the 
assembler. The assembler gave birth to the 
compiler. Now there are ten thousand lan- 
guages. Each language has its purpose, 
however humble. Each language expresses 
the yin andyang of software. Each language 
has its place within the Tao. But do not pro- 
gram in Cobol if you can avoid it." 

The Tao Programmer 

It never fails that during a typical phone 
conversation with a computer user, the sub- 
ject of programming languages comes up. 

"You programmed all that in assembly 
language?" asks the user in an unbelieving 
tone. The user assumes assembly language 
is a dark, oozing pond of scum and quick- 
sand just waiting for its next victim. 

The truth is that all programs are writ- 
ten in assembly language. High-level 
languages— Pascal, C, Cobol, Fortran, 
etc.— all convert pseudo-English program- 
ming statements into assembly code. The 
assembly code is then converted into ma- 
chine code, which runs on your computer. 
For example, suppose a Pascal program is 
written to print the words "Hello, world" 
on the screen. The Pascal code might look 
like this: 



begin 

WRITELNC'Hello, world"); 
end; 



WRITELN is Pascal's command to write 
a line of text to the screen. The Pascal com- 
mands are typed into an editor or word 
processor, then saved to a source-code file. 
The Pascal compiler program is opened, 
and it asks for the name of the source-code 
file. The Pascal compiler converts the Pas- 
cal source code into an assembly language 
program. The assembly code might look 
something like this: 



BEGIN PEA nyS-tring 

MOUE »9,-CSP) 

TRAP 81 

ADD.L 86, SP 
END RTS 
nyString DC.B 'Hello, world', 8 



It probably doesn't look as pretty, but the 
assembly language program writes the same 
message to the screen. After a few moments 
of prestidigitation, the assembly code is 
turned into the machine code that will print 
your line of text. 

So why not program everything in Pas- 
cal? Why use assembly language at all? And 
why do graham crackers fall apart after five 
minutes in milk? 

During the translation process, the Pas- 
cal compiler must be able to convert the 
Pascal source code into assembly language 
regardless of what the source code is try- 
ing to do. The designers of Pascal had to 
consider every possible program that could 
be written in Pascal to make certain the 
compiler would work at all times. 

Unfortunately, all the processing that's re- 
quired to translate the source code into as- 
sembly code takes much time. When the 
Pascal compiler finally finishes the job, a 
significant portion of your life will have 
passed by. Also, the translation process is 
not perfectly accurate. The three lines of 
Pascal in our example above might convert 
into hundreds of lines of assembly code. 

The insulation a high-level language 
offers the programmer from the computer 
and operating system can become the most 
significant problem. The simple Pascal pro- 
gram shown above has a 99.999% chance 
of running properly on your ST computer; 
however, what happens if it doesn't work? 
More importantly, suppose you have writ- 
ten 10,000 lines of good, clean Pascal source 
code. What happens when you run the pro- 
gram and 24 bombs appear across the 
screen? Can you really say you are fully in 
control of the computer? Is it your program 



that's bombing? Or is the compiler the prob- 
lem? In either case, your graham crackers 
get soggy while you fight to get your pro- 
gram to work. 

Perhaps the question should be, "Why 
use a high-level language?" 

It doesn't take long for the novice 
programmer to realize that the first half of 
every programming project is a repeat of 
the last project. Every program must initial- 
ize the computer, paint some pictures or text 
onto the screen, handle receiving input from 
the keyboard or mouse and be able to ter- 
minate (quit) to the program that called it. 
For the most part, these are basic functions 
of every program. Once written, they can 
be used over and over again. The master 
programmer eventually builds a library of 
basic functions that can be drawn from at 
the start of a new project. For that reason, 
assembly language isn't as hard to work 
with as you might think. Much of the code 
you write can be used over and over. In fact, 
programming in assembly langauge, using 
a complete library of subroutines, can be 
much like programming in a high-level 
language— but without the drawbacks. 

"Something mysterious is formed, born 
in the silent void. Waiting alone and unmov- 
ing, it is at once still and yet in constant 
motion. It is the source of all programs. I 
do not know its name, so I will call it 'the 
Tao of Programming. ' ' ' 

—The Tao Programmer 

The arguments over programming in a 
high-level language or assembly language 
are moot. In today's world of high- 
performance personal computers, it is 
necessary to master all programming lan- 
guages to complete a project. If the program 
is a large and complex database written in 
assembly language, a high-level language 
can easily create small utility programs that 
test the functions of the database. If a graph- 
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ics program is written in a high-level lan- 
guage, the functions to plot lines, circles 
and other patterns onto the screen will run 
faster if written in assembly language. 

A renaissance computer-programming 
spirit has emerged, bringing humans out of 
the Dark Ages into a new day of enlighten- 
ment. It emphasizes the amazing versatili- 
ty of mankind released from church 
doctrine and dogma. It lets us use our minds 
to use whatever materials we need to 
build a structure, develop a process and find 
the answers to life's perplexing questions. 
The personal computer frees us to use what- 
ever language we need to get a task accom- 
plished. More and more programmers are 
proving untrue the myth that high-level lan- 
guages are better than assembly language. 

' 'If the Tao is great, then the operating 
system is great. If the operating system is 
great, then the language is great. If the lan- 
guage is great, then the application is great. 
The user is pleased and there is harmony 
in the world." —The Tao Programmer 

So, why should there be all this talk about 
Tao programming? Taoism is an ancient 
philosophy that teaches the natural relation- 
ship between man and the things around 
him, computers included. It can be thought 
of as the spirit of creativity, the energy that 
pushes an apprentice to learn new abilities. 

In the time of the Asian emperors, war- 
riors protected the land and people from in- 
vaders and enemies. Being a warrior was 
a noble craft, learned only after many years 
of training and apprenticeship. The master 
taught the student how to connect the ener- 
gy of the soul (Tao) with the abilities of the 
body. Eventually, the student graduated by 
creating his own weapon. 

Learning to program in assembly lan- 
guage follows a similar path. It might sound 
foolish to talk about ancient philosophies, 
but consider this: Luke Skywalker (in the 



film, Star Wars) only fought and defeated 
Darth Vader after building his own weapon. 

Each month we will explore the talents 
laying dormant in your mind. If you know 
how to switch the computer on and use a 
word processor, you know the basics of how 
a computer works. My task is to show you 
what is happening behind the windows and 
menus to make the computer function. We 
will work together to build a computer pro- 
gram, and eventually you will be able to do 
it yourself. You will build your own 
weapon. 

The tools you gather will make the jour- 
ney to assembly language programming 
much easier. To understand the material 
during your apprenticeship, you should have 
the following reference materials: The 
68000: Principles and Programming by Leo 
J. Scanlon (Howard W. Sams & Co. , Inc. , 
4300 W. 62nd Street, Indianapolis, IN 
46268); 68000 Assembly Language 
Programming by Gerry Kane, Doug 
Hawkins, Lance Levanthal (Os- 
borne/McGraw-Hill, 2600 Tenth Street, 
Berkeley, CA 94710); Atari ST Internals by 
K. Gerits, L. Englisch, R. Bruckmann 
(Abacus Publishing, P.O. Box 7211, Grand 
Rapids, MI 49510); and The Tao of 
Programming by Geoffrey James (Info- 
books, P.O. Box 1018, Santa Monica, CA 
90406). 

These books should be kept next to your 
computer. They are invaluable at times 
when you scratch your head and wonder 
why your program has expired. They also 
present vastly different views of the same 
subject. 

68000 Assembly Language Programming 
is a basic university-level course on 
programming, the most complete text avail- 
able for the 68000 system. However, it is 
also very thick and sometimes bogs down 
with minute details. On the other hand, 
68000 Principles and Programming is a 
macho programmer's book. It is a bare- 



bones book that assumes you have had ex- 
perience with other programming lan- 
guages. You will find many programming 
examples and instruction reference pages. 
Atari ST Internals does a good job describ- 
ing the ST operating system functions avail- 
able to programmers. 

Kept in your computer are the tools that 
assemble and debug your assembly lan- 
guage source code. All programmers need 
a good editor, assembler, debugger and 
high-level language. For this column, I 
recommend the following programs: HiSoft 
BASIC Professional; HiSoft Devpak ST 
(Michtron, 576 S. Telegraph, Pontiac, MI 
48053); and Templemon monitor (a "share- 
ware" program available on DELPHI and 
most other online services; it is also on this 
issue's ST disk). 

DevPak ST is a combination program edi- 
tor and assembler. The new HiSoft 
products, marketed in the United States and 
Canada by MichTron, provide the beginning 
programmer with a decent editor, good as- 
sembler and great BASIC language. The ex- 
amples and source code presented here will 
be created using Devpak ST and HiSoft 
BASIC. 

The combination of HiSoft BASIC and 
Devpak was also chosen because they are 
the only fully integrated packages for ST 
programmers. Assembly language pro- 
grams created in Devpak are easily incor- 
porated into HiSoft BASIC programs. There 
might be a better individual assembler and 
high-level language, but they won't be able 
to use each other's resources to the extent 
of the HiSoft packages. 

Bugs in your program have to be hunted 
down and smashed. Templemon is the best 
bug-swatting program for the ST. When 
your prized program crashes across your ST 
screen, Templemon shows you where and 
why the program failed. In the two years 
of use, Templemon has proven itself to be 
the most reliable, solid and stable debug- 
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ger available for the ST. And the best part 
is the price: Templemon is a shareware 
product. If you like it and use it, Thomas 
Templemann, the author, asks for a mod- 
est $15 contribution to his bug-swatting 
cause. 

Your final purchase of reference materi- 
als comes in the form of a subscription. 
DELPHI, CompuServe and GEnie are on- 
line services that provide an invaluable 
amount of utilities, source code examples 
and direct feedback from other program- 
mers. If you are going to do anything with 
your newfound ability to program in assem- 
bly language, you will certainly need con- 
tact with other programmers. 

"A well-written program is its own heav- 
en; a poorly written program is its own 
hell." The Tao Programmer 

Over the next few months, we will jour- 
ney where no programmer has gone before, 
seeking out new intelligence and interest- 
ing subroutines. At the end of our quest, 
the way to building your weapon will have 
been prepared, and you will emerge the new 
programming warrior. 



The weapon we'll be building is a work- 
ing text editor. The text editor will use GEM 
following the "Visual Interface Guidelines" 
that appeared in the February 1989 issue of 
ST-LOG. The editor will use the mouse to 
select words, manipulate windows to show 
text, handle drop-down menus, print the en- 
tered text onto paper, use the ST file sys- 
tem to store and retrieve text, and search 
and replace words and letters. 

The text editor will be completed with in- 
structions on how to write the User Man- 
ual. Many programmers gain the ability to 
create assembly language source code, 
while their brain loses the important abili- 
ty of explaining the creation. The master 
programmer can write the documentation 
necessary for users to understand the pro- 
gram. There is an easy method of writing 
documentation that we will use with all of 
the functions, procedures and source code 
we develop. Compiling the User Manual 
can be done using the text editor we create. 

Like a magician, once you learn the craft 
of assembly language programming, it is 
best to keep the public guessing as to how 
you did it. Don't reveal the hidden wires or 
the bunny waiting in your top hat. 



When asked, "You programmed all that 
in assembly language?" pause a few mo- 
ments while the person's mind contemplates 
long strings of numbers and complex 
mathematical formulas. Finally, reply, "Yes, 
but it really wasn't that hard." And bask in 
the glory of your new superior-being sta- 
tus. You will have become The Master 
Programmer, n 




Frank Cohen has been developing Atari 
programs since his first commercial prod- 
uct, Clowns & Balloons (written in 6502 as- 
sembly language). He later developed 
Regent Base, an SQL 4GL database (writ- 
ten in 68000 assembly language). He 
spends his free time meditating while watch- 
ing the sun rise over Long Beach, 
California. 
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Run any ST program simply by pressing a 
"hot" key...from the ST desktop! 

No more wading Ihrougn iolders lo run 
programs. 

Up to 54 programs, documents, or configu- 
ration files may be installed in a single menu. 
Load and Save complete menus, with a 
keypress or with the GEM file selector. 
Run a program by clicking on its name in the 
HotWire menu, or by pressing its "hot" key 
from the Menu or the desktop! 
Call up the HotWire Menu instantly from the 
GEM desktop with the keyboard or the 
mouse! 

Unique "work file" features make HotWire an 
excellent shell for developers. 
HotWire will change the way you 
use your ST! $39.95 



Utilities- 

A collection of very useful programs and 

desk accessories! 

MultlFile: an amazing multi-leatured file 

maintenance utility that runs as either a desk 

accessory or a program! 

AUTO Organizer: reorganizes your AUTO 

folder. ..In a split secondl 

Art Gallery 2.0: a multi-lormat graphics 

viewer/slideshow that runs as a desk 

accessory or a program! 

Font Tricks 2.0: Replaces the system font 

with a custom font, and prints it to an Epson 

printer! (19 fonts included.) 

CodeCopy: a fast disk copying program, 

designed for making multiple copies. 

CodeHead Ramdlsk and Print Spooler. 

ZeroDisk: Erase floppy disks in a split 

second, without reformatting! 

And morel 



$29.95 



CodeHead's 



MIDIMAX 



Create strings of MIDI commands triggered by any MIDI 

event (MIDI macros). 

Real-time multi-voice, multi-channel harmonization. ..single 

notes produce 18-note chords on any channels). 

Switch instantly to any one of 8 MIDI chord maps, and 8 

sets of macros! 

Turn your ST into an intelligent THRU box, with unlimited 

keyboard splitting, filtering, and remapping. 

MIDIMAX runs as either a desk accessory or ^jq qc 

a program! ^'^ 



FatBack 

A FAST and intelligent hard 
disk backup system. 
Combines the speed of an 
"image" backup with the 
convenience ol a "file" backup! 
Back up to floppy disks, or 
from one partition to another! 
Extract individual 
files from image *_ , ft - 
backup! 5*34.^3 



aPlwCI I EP«NK 

Unlimited desk accessory power for the 
Atari STI 

. Break through the GEM limit of six desk 
accessor iesT 

• Load and use up to 32 accessories or more 
at any time... without rebooting! 

• Tested with hundreds of standard ST desk 
accessories! 

• Flexible configuration options make it easy 
to customize MultiDesk. 

■ Run desk accessories as If 
they were programs! 



$29.95 



• The powerful and complete replacement 
for Atari GDOSI 

• Join the ranks of users who are free of 
GDOS slowdown. 

- Change fonts and device drivers for GDOS 

programs. ., without rebooting! 
. Automatically load the correct ASSIGN files 

for each program you use. 

• Special "solid" line mode actually 

speeds up all line drawing by *- . „_ 
about 25%! $.54^5 



Phone: (213 386-5735 PodpHead Software 

Visa and Mastercard accepted. „^ e „° ^A 

Shipping charge: US S2, P.O. BOX 74090 

Canada S3 Europe S5 CA LOS Angeles, CA 90004 

residents add 6.5% sales tax. & ' 




ProCopy 



ST 

BACKUP 

UTILITY 

You can't backup your software 
because copy protection locks 
you out. ProCopy is the key! 

■ Protects against the accidental loss of 
expensive software 

■ Works with all Atari STs 

■ Copies both S/S & D/S disks 

■ Use with 1 or 2 disk drives 

■ Not copy protected 

■ FREE shipping and handling 

■ TOLL-FREE telephone number 

■ Updates available to registered owners 

■ Orders shipped same day 

■ Disk analyze function included 



Dealer 

Inquiries 

Welcome 



and C.O.D. 
orders 



S 34-95 



CIRCLE #123 ON READER SERVICE CARD. 



Call (800) 843-1223 

Send check for S34.95 (overseas add S2.00 for air mail) to: 

PROCO PRODUCTS 

P.O. BOX 665, CHEPACHET, RHODE ISLAND 02814 USA 
(401)568-8459 

Available THE MOVING FINGER CO, 

in Europe Building 2 

Shamrock Quay 

Southampton, SOl-lQL 

England 

Tel. 0703-229041 

CIRCLE #124 ON READER SERVICE CARD. 



TECH-SOFT 

COMPUTER WHOLESALE | 

324 Stirling Highway 

Claremont 

Western Australia 60101 

Tel. 09-385-1885 
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by Clayton Walnum 



WHITE NOW 




MORE HELPFUL 

FUNCTIONS 
THAN YOU 

CAN SHAKE 
TICK AT. 



Since the release of the Magic Sac car- 
tridge, ST owners have become more and 
more interested in running Macintosh soft- 
ware on their computers. The Spectre 128 
cartridge, which was released by Gadgets by 
Small lasi year, has increased this interest 
enormously by allowing the ST to emulate 
a Mac Plus and thus run many software pack- 
ages not usable on the Magic Sac. 

Because Macintosh emulation on the ST 
has become so popular, we have decided to 
take a little space each month to give you a 
quick preview of the most interesting Macin- 
tosh software. Each piece of software we 
recommend here will run on an ST equipped 
with a Spectre 128 cartridge. We do not guar- 
antee, however, that they will run on the Mag- 
ic Sac. Some will, some won't. 

Introducing WriteNow 

No one can disagree that word processing 
is the number one use for a home computer. 
For that reason, our first ST Macintosh 
column will give you a preview of one of the 
top word processors for the Macintosh. 
WriteNow 2.0 from T/Maker Company has 
taken the Macintosh world by storm, giving 
MacWrite serious competition for the Mac 
word-processing blue ribbon. Which of the 
two programs is better depends on whom you 
talk to, but every day, more and more people 
seem to be choosing WriteNow. 

WriteNow is a graphics-oriented word 
processor, which actually comes close to a 
simple desktop-publishing program. It coin 
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Performance UJord Processing 
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WnteAto 

FOR MACINTOSH 
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More than four years in development , WriteNow 
For Macintosh was designed as a performance word processor 
intended for the majority of Macintosh users. It combines 
extensive capabilities with the ease of use that has made the 
Macintosh unique, WriteNow For Macintosh can be described 
in two words: WYSIWYG and FAST. 

• By WYSIWYG , we mean completely '\vhat-you-see-is-what- 
you-get." Not only fonts, font sizes, styles, and paragraphs 
are shown, but headers, footers, footnotes, columns, and 
page breaks are always shown on the screen as they will 
appearwhen printed. It is no lon g ernecessaryto re pag inate or 
reformat a document to see how it will appear. When you print 



one page in the middle of a, large document , m 

Qillljilllll lll p HI 



**i 






Because WriteNow For Macintosh v. 

aMacintosh application, rather than bein 
computer, it carefully follows the Macinto 
guidelines. This has the advantage of mi 
especially familiar to MacWrite users , I 
complete cut and paste between 
accessories. 



The manual 

WriteNow For Macintosh was writte 

principal author of 6tsn& AtiwrOvs/i , 
information for Macintosh developers. I 
gf WriteNow For Mac in 
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By WYSIWYG, we mean completely '^hat-you-see-is- 
what-you-get," not only fonts, font sizes, styles and 
paragraphs are shown, but headers, footers, footnotes, 
columns, and page breaks are always shown on the 
screen as they will appear when printed. It is no lon ger 
necessary to re pag inate or reformat a document to see 
how it will appear. When you print one page in the middle 
of a large document, you don't have to wait for all the 
pages before it to be repaginated; the page will be printed 
immediately. This benefit becomes immediate clear to 
those users who have had to wait 



A number of innovations were developed to eliminate these 
perf ormance problems . It is possible to comfortably edit large 
documents as easily as small documents. For example, the 



user interface guidelines. Thishasthi 
easy to learn, and especially familiar 



support Switcher, complete 
applications, desk accessories and 
support of graphics from graphics 
MacDraw and equation editor a 
accessories. 



The manual - I ~ 

WriteNow For Macintosh was < 

author of Inside Macintosh, the definit 
for Macintosh developers. Man^ 
capabilities of WriteNow For Maci 
overall smooth feel. All drawing to the 
"off screen" memory area, then copie 
This completely avoids objectionabl 
flashing of awhile screen and text. It 
fasterlhan the screen can be update< 
might occur in quick successif 
superscripting, subscripting, changin 
need to completely redraw the s 
document aftereach operation. Almo: 
operation can be canceled before 
Command-period . 



l^Page 125" 



bines the now-standard WYSIWYG (What 
You See Is What You Get) screen display with 
the ability to import pictures and have up to 
four columns of text per page. Fonts and font 
sizes, as well as text styles (bold, italic, un- 
derlined, shadowed, etc.) can be easily select- 
ed from the menu bar and will appear 
on-screen exactly as it will look in the final 
printout. Font sizes can be from four to 127 
points. When a new font is chosen, the Font- 
Size menu will show, as outlined text, the 
point sizes that look best for that font, 
eliminating much trial and error. 

While most word processors limit you to 
a certain number of headers or footers (some- 
times only one), WriteNow can accommodate 
as many as you choose. For added flexibili- 
ty, headers and footers can be set to appear 
only on odd or even pages. In addition, time 
and date "variable markers," which are au- 
tomatically replaced with the current time 
and date both on the screen and at printout 



time, can be placed in the hi 
(or anywhere in a document, for that mat- 
ter), assuring that your correspondence is al- 
ways properly dated. 

The Ruler 

WriteNow formats each paragraph in your 
document according to a "ruler," whii 
may modify to v alious you 

like. Each paragraph has it: 
although most paragraphs will shun- the same 
style, any number ol different rul 
used within a document. Margins and tabs 
are sei b) dragging them with the mouse from 
the tab "toolbox." or from their current po- 
sition on the ruler, to th rigs. Four 
types of tabs are available: left justifi 
tabs (the type yot itotned to u 
right-justification tab 

decimal tabs. Decimal tabs will align num- 
bers at the decimal point. 

Also available on the ruler are line-spacing 



and text-alignment icons. A simple click of 
the mouse on one of these icons will cause 
a paragraph's text to be left-justified, both 
right- and left-justified, centered. 01 right 
justified. Line spacing is changed similarly. 

Changing a paragraph's ruler is a simple 
process. Place the cursor anywhere in the 
paragraph you wish to modify, and click on 
the ruler window. The selected paragraph be- 
comes highlighted, and its ruler appears. Any 
changes made to the ruler will be reflected 
immediately on the screen display. 

Rulers may be copied and pasted, allow- 
ing you to use a specially formatted paragraph 
style in scattered places throughout a docu 
men! without having to redo the ruler each 
lime. This capability offers some of the ad- 
vantages of "style sheets." which are usual- 
ly available only in desktop-publishing 
programs. Clearly, WriteNow's ruler is one 
of its most powerful features and is what sets 
this program apart from its competition. 
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More Features 

ntioned previously that WriteNow al- 
mporting of graphics into your 
ocuments. In addition, any graphic element 
resized either proportionately or non- 
proportionately— another feature typically 
bund in a desktop-publishing program. 
Of course, no full-featured word proces- 
■ inplete without a spelling 
i. WriteNoWs spelling checker sports 
both a ml 100,000-word dictionary. 

Which dictionary you load depends on avail- 
The spelling checker is fast and 
ill quickl) find suggested spellings forun- 
i words. The program also has the 
ability to learn new words. 

I we ami beyond the major feati 
VriteNow boasts more helpful functions than 
on can shake a stick at. The search-and- 
i can operate on "non- 
rinling" characters, such as spaces ami car- 
lurns. and even supports "wild card" 



cr 
hi 

Wl 

wi 



searches where a question mark can repre- 
sent any character. A "Select All" function 
allows you to mark instantly an entire docu- 
ment in onler to perform global changes. 
With the "Revert to. . ." function, you can 
abandon the current document in favor of one 
of iis previous versions up 10 two generations 
past. The intelligent I ture will not 

only undo your last action ( if it's undi 
but will tell sou what that last action was. You 
can "Show Markers' ictly where 

placed items, like hi ! loot- 

ers, "Show Space" to show non-printing 
characters, including spaces and returns, and 
"Hide Pictl Ip the display by 

not forcing the program to redraw complicat- 
ed graphics. WriteNow also has full footnot- 
. [labilities. 

The Manual 

No software package is complete without 
a manual, oi course, and WriteNow's manu- 



al is terrific. The first few chapters comprise 
a hands-on tutorial that takes you through the 
program's main features step by step, with the 
rest of the volume giving a more detailed 
description of the program and its many tunc- 
lions. The manual is clearly written in a 
friendly, disarming style and includes a glos- 
sary and a complete, usable index. 

Conclusion 

If you've got a Spectre 128 installed on your 
ST, you might want to check out WriteNow 
2.0, the winner ofMacUser's Editor's Choice 
award and the program about which Steve 
Jobs said, "This is the word processor that 
we designed and built the Macintosh for." 

WRITENOW 2.0 

$195 

T/Maker Company 

1390 Villa Street 

Mountain View, CA 94041 

(415) 962-0195 <R 
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handle_keys O 
t 

int button; 

if C loaded && "search && {canceling ) 
switch C key ) C 

case CNTL_A: 

nenu-tnornal C nenu_addr, CHECKS, FALSE IS 

do.auto C) ; 

nenu-tnornal t nenu_addr, CHECKS, TRUE ); 

break; 

case CHTL_E: 

nenu-tnornal t nenu_addr, CHECKS, FALSE 3; 

do_enter t) ; 

nenu-tnornal t nenu_addr, CHECKS, TRUE ); 

break; 

case CHTL_M: 

nenu_tnornal ( nenu_addr, FILEBAR, FALSE ); 

do_new_nnth () ; 

nenu_tnornal t nenu_addr, FILEBAR, TRUE ); 

break; 

case CHTL_P: 

nenu-tnornal t nenu_addr, CHECKS, FALSE ); 
J? do_check_canc () ; 

2 nenu-tnornal C rienu_addr, CHECKS, TRUE ); 

E break; 

case CHTL_R: 

nenu_tnornal C nenu_addr, CHECKS, FALSE ) 
5 do_reconcil () ; 



g break; 

© > 

O 

CC if t ! loaded ) 

& switch ( key ) C 



nenu_tnornal t nenu_addr, CHECKS, TRUE J; 



case CHTL_H: 

nenu_tnornal C nenu_addr, FILEBAR, FALSE ); 

do_newacct () ; 

nenu-tnornal I nenu_addr, FILEBAR, TRUE )i 

break; 

case CHTL_0: 

nenu_tnornal t nenu_addr, FILEBAR, FALSE ); 
button = get_acct () ; 
if C button ) 

open_acct C filename ); 
nenu_tnornal t nenu_addr, FILEBAR, TRUE ); 
break; 

case CNTL-Y: 

nenu_tnornal C nenu_addr, UTILITY, FALSE J; 

do_new_year tJ ; 

nenu_tnornal C nenu_addr, UTILITY, TRUE ); 

break; 

case CHTL_I: 

nenu_tnornal C nenu_addr, UTILITY, FALSE ); 
do_inport () ; 

nenu-tnornal ( nenu_addr, UTILITY, TRUE 3; 
break; 
} 

switch C key J C 

case CHTL_Q: 

nenu_tnornal C nenu_addr, FILEBAR, FALSE 3; 

do_quit () ; 

nenu-tnornal ( nenu.addr, FILEBAR, TRUE ); 

break; 

case CHTL_S: 

if C loaded && {canceling ) { 

nenu_tnornal t nenu.addr, CHECKS, FALSE ); 

do_search C) ; 

nenu_tnornal C nenu_addr, CHECKS, TRUE ); 
} 
break; 

case CNTL_C: 
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if ( loaded ) t 

nenu_tnornal C nenu_addr, FILEBAR, FALSE 3, 

do_wind_close () ; 

nenu_tnornal ( nenu_addr, FILEBAR, TRUE 3; 
> 
break; 

case CNTL.D: 

nenu_tnornal C nenu_addr, UTILITY, FALSE 3; 

get_new_date C3 ; 

nenu_tnornal £ nenu_addr, UTILITV, TRUE ); 

break; 

case CNTL_M: 

if ( loaded ) i 

nenu_tnornal C nenu_addr, PRINT, FALSE 3; 

print_wind (3; 

nenu_tnornal C nenu_addr, PRINT, TRUE 3; 
} 
break; 

case CNTL-G: 

if ( loaded 3 i 

nenu_tnornal C nenu_addr, PRINT, FALSE 3; 

print_reg (3; 

nenu_tnornal t rtenu_addr, PRINT, TRUE 3; 
} 
break; 



do_newacct (3 
t 

int choice, okay; 

int dial_x, dial_y, dial_w, dial_h; 

clear_newacct (3; 

forn_center t neuacct_addr, &dial_x, &dial_y, &dial_w, &dial_h 3; „ 

forn_dial C FMD_START, B, B, 10, 10, dial_x, dial_y, dial_w, dial_h 3; 2 

objc_draw C newacct_addr, 8, 8, dial_x, dial_y, dial_w, dial_h 3; q 

do C % 

choice = forn_do C newacct_addr, NEHNAME 3; ^ 

newacct_addrtchoice] .ob_state = SHADOWED; 

switch C choice 3 C C 

(A 

case NEWOK: 2 

okay = check_newacct C3 ; 2 

if C lokay 3 © 

objc_draw C newacct.addr, 0, 8, V» 

dial_x, dial_y, dial_w, dial_h 3; I 

else 

newacct_file (3; 
break; 

case NEMCANCL: 

clear_newacct (3; 
} 
} 
while ( okay == FALSE && choice != NEMCANCL 3; 

forn_dial t FMD.FINISH, 8, 8, IB, 18, dial_x, dial_y, dial_w, dial_h 3; 

> 

check_newacct t) 
i 

int x, okay; 

okay = TRUE; 

for C x=NEWNAME; x<=HEWBALNC; ++x 3 { 

string = get_tedinf o_str ( newacct_addp, x 3; 
if ( stringCBl == '0' 3 
okay = FALSE; 
} 
if C lokay 3 

f orn_alert(l, "111 [You nust conpletel the forn to start|a new accountIJA 
[OK] "3; 

return ( okay 3 ; 
} 
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newacct_file tl 

int choice, okag, x; 

int dial_x, dial_y, dial_w, dial_n. 

string = get_tedinf o_str C newf ile_addr, FILEHAME J) 

stringlO] = B; *.,«*. 

for t x=8; x<64; f ilenaneIx++]=B 3, 

newfile_addrENEWOK].ob_state = SHADOWED; 

forn.center C newf ile.addr, &dial_x, &dif l-a» &dial_w, &dial_h J , 

fornldial ( FMD_START, 0, 8, IB, 18, di*l T x, dialog, d"!-^ dial_h 3, 

objc_draw t newfile_addr, 0, 8, dial_x, dial_y, dial_w, dial_h 3, 

choice = fom_do C newf ile_addr, FILEHAME 3; 
newfile_addrtchoicel.ob_state = SHADOWED, 

switch C choice 3 t 

case FILEOK: 

okay = check-file C3 ; 
if C "okag 3 

objc_draw C newf ile_addr, 0, B, .,,,.,. 
dial-x, dial_u, dial_w, dial_h 3, 

string = get_tedinf o_str t newf ile_addr, FILEHAME 3; 
strcpy ( acct_nane, string 3; 
filenanelBl = Dgetdrv C3 + "a'J 



w filenanell] = 



Dgetpath C &f ilenaneC2], DFLT-DRU 3; 

f ilenanelstrlenCf ilenaneJ] = 'v\ ; ,. 

strcpg C SfilenaneEstrlenCfilenane)], string J. 

strcpg ( &f ilenanelstrlentf ilenane)], ".MCK 3; 

acctfile = fopen ( filenane, "bw" 3; 

if t acctfile != B 3 C 
5 write_new_inf o () J 

< open-acct C filename 3; 

* > 
© ) 

O break; 

et 

* case FILECAHC: , , 

string = get_tedinf o_str I newf ile_addr, FILEHAME J, 
stringIB] = B; 

> 

while C lokay && choice != FILECAHC 3; 

fom_dial ( FMD-FIHISH, B, 8, 18, IB, dial_x, dial_g, dial.w, dial_h 3; 
} 

clear_newacct () 
t 

int x; 

for ( x=HEWHAME; x<=HEWBALHC; ++x ) t 

string = get_tedinf o_str C newacct_addr, x IS 
stringIB] = 'B'; 

newacct_addrtHEWCAHCLl.ob_state = SHADOWED; 
} 

char *get_tedinfo_str C tree, object 3 
OBJECT Ktree; 
int object; 
C 

TEDIHFO *ob_tedinfo; 

ob_tedinfo = ITEDIHF8 *3 treelobj ect] . ob_spec; 
return C ob_tedinf o->te_ptext 3; 
} 

checkJfile C3 
i 

int okag; 

string = get_tedinf o_str ( newf ile_addr, FILEHAME 3; 
if t strlen C string ) == B 3 C 

forn_alerttl, "111 [Invalid filenane!] I0K3 "3; 

okay = FALSE; 
> 
return I okay 3 ; 

no_decinal C s 3 

char *s ; (continued on paoi 35) 
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(CONTINUED FROM PAGE 1 J3) 

Line 750 sends the program back to the 
section of code beginning at Line 720 (af- 
ter printing a blank line). 

The only time we'll get to Line 750 is 
when COUNT is less than 4. Also notice 
that by going to Line 720, we are not set- 
ting COUNT back to 0. 

Line 760 is where the program will go 
when it encounters an error. 

What error are we expecting? The end- 
of-file error, of course, generated whenev- 
er we try to read more data than is contained 



in a file. In this case, without the TRAP 
statement we'd get an "ERROR 136 AT 
LINE 720" on the screen, and the program 
would come to a halt— not an elegant way 
to treat our program's user. Rather than let 
this happen, we'll handle the error ourselves 
by sending the user back to the menu after 
informing him that we've reached the end 
of the file. The problem with this method 
is that any error will trigger the TRAR 
We're only assuming the error encountered 
will be the end-of-file error. In a complete 



program, that isn't good enough. 

Line 770 waits for the user to press Re- 
turn. Then it closes the open file and returns 
the user to the menu. 

Conclusion 

That finishes our discussion for this 
month. I hope that examining this program 
has helped you better understand what 
we've learned over the past few months. 
Next time, we'll take our simple address 
program and add enough error-trapping to 
make it foolproof. See you then, o 
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PH 18 
HI 20 
KM 30 
PZ 40 
MS 50 
FG 60 
RT 70 
PT 80 
BG 90 
XR 100 

o>, 

00 no 

Yfl 120 
BC ISO 
YE 140 
QM 158 
BE 168 
JA 178 
IE 180 
EG 190 
tlC 200 
DR 210 
GE 220 
DM 230 
UP 240 
JJ 250 
ZU 260 
GO 270 
RE 280 
TM 290 
JO 380 

01 310 
05 320 
YE 338 
WW 340 
VI 358 
m 360 
BR 370 
AJ 380 
OK 398 
OP 488 
YB 418 
SI 428 
YF 438 
OK 440 
BO 458 



REM KKXXHMXXXXXXXKXXXXMXXXXMMMM 



REM * 
REM * 
REM * 
REM * 
REM * 
REM * 



BASIC TRAINING 
SIMPLE ADDRESS BOOK 

by Clayton WalnuM 

Copyright 1989 
by ANALOG Computing 



REM XXXXXXXXXXXXXXXXXXXXXXXXXXX 

REM 

DIM NAMES C30) , ADDRESS? C38J , CITY* C3 
PHONES (15) , ft* CI) , FILENAMES CIS) 

REM 

REM XXXXXXKXXXXXXXXXXXXXXXXXXXX 

REM * PRINT MENU * 

REM XMXXXMXXXXMMKXXXXXXXXXXXXXX 

REM 

? CHRSC125) 



? "j 



HREATE FILE 
I0AD FILE 
QEIH FILE 
GJUIT 



I' 



I" 

J" 



INPUT AS 

IF AS="C" OR AS^'C" THEN 370 

IF AS="L" OR AS="1" THEN 458 

IF AS="0" OR AS="q" THEN END 

IF AS="M" OR A$="V" THEN 680 

GOTO 268 

REM 

REM xxxxxxxxxxxxxxxxxxxxxxxxxxx 

REM * CREATE FILE * 

REM xxxxxxxxxxxxxxxxxxxxxxxxxxx 

REM 

? "FILENAME"; : INPUT FILENAMES 

OPEN ttl, 8, 8, FILENAMES 

GOTO 520 

REM 

REM XXXXXXXXXXXXXXXXXXXXXXXXXXX 

REM * LOAD FILE * 

REM xxxxxxxxxxxxxxxxxxxxxxxxxxx 

REM 

? "FILENAME"; : INPUT FILENAMES 



BSni 



AT 460 OPEN 81, 9, 0, FILENAMES 

RD 470 REM 

YP 480 REM XXXXXXXXXXXXXXXXXXXXXXXXXXX 

UX 490 REM tt GET ADDRESS * 

YA 508 REM xxxxxxxxxxxxxxxxxxxxxxxxxxx 

QS 518 REM 

MR 528 ? :? "NAME!": INPUT NAMES: IF NAME$= 

■"■ THEN 620 
FY 538 ? :? "ADDRESS:": INPUT ADDRESSS: IF 

ADDRESSS::'"' THEN 628 
MT 540 ? :? "CITY, STATE « ZIP:":INPUT CI 

TY$:IF CITY$="" THEN 620 
ON 550 ? :? "PHONE:": INPUT PHONES: IF PHON 

ES="" THEN 620 
HI 560 ? :? NAMES:? ADDRESSS:? CITYS:? PH 

ONES 
EK 570 ? :? "IS THE ABOME ENTRY OKAY CY/N 

)"; : INPUT AS 
FT 580 IF AS="N" OR AS="n" THEN ? :? "PLE 

A5E REENTER THE ADDRESS.": GOTO 520 
ST 590 IF A$<>"Y" AND ASO"y" THEN ? it " 

PLEASE ANSWER Q OR [D„":GOTO 570 
IG 600 ? ttl;NAME$:? ttl; ADDRESSS:? «l;CITY 

S:? ttl; PHONES 

NX 610 GOTO 520 

BR 620 CLOSE ttl: GOTO 160 

OX 630 REM 

YJ 640 REM XXXXXXXXXXXXXXXXXXXXXXXXXXX 

MO 650 REM * MIEW FILE * 

YN 660 REM XXXXXXXXXXXXXXXXXXXXXXXXXXX 

RF 670 REM 

BW 680 ? "FILENAME"; : INPUT FILENAMES 

YO 690 OPEN ttl, 4,0, FILENAMES 

05 700 TRAP 760 

UO 710 C0UNT=0:? CHRSC125) 

ET 720 INPUT ttl; NAMES: INPUT ttl; ADDRESS$:I 

NPUT ttl; CITYS: INPUT ttl; PHONES 
TR 730 ? NAMES:? ADDRESSS:? CITYS:? PHONE 

S 
GN 740 C0UNT=C0UNT+1:IF C0UNT=4 THEN ? :» 
"PRESS CRETURN] FOR MORE":INPUT AS:G0 

TO 710 
DP 750 ? :G0T0 720 
WC 760 ? :? "END OF FILE.":? "PRESS IRETU 

RNJ FOR MENU." 
LS 770 INPUT AS i CLOSE ttl: GOTO 160 
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by 



Karl E. Wiegers 



In every intellectual endeavor, certain in- 
dividuals become widely recognized as 
gurus. These insightful chaps (and 
chapettes) offer unique perspectives on 
our thinking, making observations the 
rest of us immediately recognize as profound 
but would never have expressed on our own. 
The computer industry is blessed with its 
share of such wise persons (I hope you think 
some of them write for ANALOG). In my 
readings of both the popular and the profes- 
sional computer literature, I've come across 
a number of their statements that struck me 
as noteworthy, either for their pithiness or 
their humor. Some of them are most enter- 
taining when presented out of context, and 
perhaps with a dash of selective editorial 
removal of intervening irrelevancies. 

Below, I present some of the more interest- 
ing quotations I've encountered. I've added 
a few clarifying words in brackets where 
necessary. The works from which these 
quotes are drawn represent a broad cross- 
section of computer publications. I particu- 
larly recommend the books by Levy, Brooks 
and Peters. I've classified these tidbits of wis- 
dom into two categories: software engineer- 
ing and philosophy. Perhaps there's really no 
difference between the two. 

Software Engineering 

"Management is suspicious of all time 
spent prior to writing hard code. It is manage- 
ment's long-standing view that the project 
team really uses all the precoding phases to 
rest up before getting into the real work of 
building the system." (Tom DeMarco, Struc- 
tured Analysis and System Specification, p. 
33.) 

"Now, after months of delay, some due to 
an unexpectedly long debugging period (there 
has never been an unexpectedly short debug- 
ging period in the history of com- 
puters) ... the program was complete." 
(Steven Levy, Hackers, p. 382.) 



"A dispassionate observer, a hypothetical 
person from Mars, might view programming 
as an activity dominated by testing, with oc- 
casional lapses into design and documenta- 
tion." (Boris Beizer, Software System Testing 
and Quality Assurance, p. 1.) 

"Programmers regard themselves as artists. 
As such, they consider keeping accurate 
records of their handiwork on a par with 
washing ashtrays." (Otis Port, Business Week, 
May 9, 1988, p. 144.) 

"The second [information realm] is the 
realm of ideas and information existing in the 
minds of men and programmers." (James 
Martin, Computer Data-Base Organization, 
2nd Ed., p. 50.) 

"Because of their exaggerated claims, some 
of the fourth-generation languages qualify as 
the ultimate technical laetrile." (Tom DeMar- 
co and Timothy Lister, Computerworld Ex- 
tra, June 20, 1988, p. 45.) 

"Reuseless code is software that is not 
worth reengineering for a new applica- 
tion .... Sometimes, programmers should let 
old code die a natural death rather than spend 
any effort trying to revive it." (Will Tracz, 
Computer, December 1988, p. 75.) 

"Structured programming has been credit- 
ed with everything from reductions in den- 
tal caries to improvements in one's sex life." 
(Author unknown.) 

"When a feature of any software works as 
advertised, regard it as a fortunate fortuity." 
(Larry Hiner, Computer Technology Review, 
May 1988, p. 20.) 

"The next two Gemini flights would be af- 
flicted by the same short landings . . . .Gemini 
V landed 130 kilometers short after a com- 
puter programmer neglected to program a 
trivial point. He programmed the earth's ro- 
tation rate at 360 degrees per day, whereas 
the actual figure is 360.98." (Dennis Cham- 
berland, U. S. Naval Institute Proceedings, 
January 1989, p. 40.) 

Philosophy 

"Is there something unique about the 
programming profession that attracts people 
who are mistake-prone by nature?. . .the only 
possible solution is the careful genetic breed- 
ing of today's best programmers." (Glenford 
J. Myers, Software Reliability, p. 15.) 

"The computer, like a human employee, is 
subject to the Peter Principle. If it does good 
work at first, there is a strong tendency to 
promote it to more responsible tasks, until it 
reaches its level of incompetence." (Dr. L. 
J. Peters and R. Hull, The Peter Principle, 
p. 146.) 

"I don't do crack. I don't do heroin. And 
I don't do desktop publishing." (Stephen 
Manes, PC Magazine, November 29, 1988, 
p. 85.) 



"Long before anyone ever heard the acro- 
nym CASE [computer-aided software en- 
gineering], back in the computing Golden 
Age, building software systems was easy. 
Users petitioned the MIS [Management In- 
formation Systems] department with requests 
for new applications, and after an [appropri- 
ate time] MIS would pass their interpretation 
of the request back in the form of a finished 
system. For some on both sides, this was a 
religious experience." (Damian Rinaldi, Soft- 
ware Magazine, April 1988, p. 51.) 

"Changing to any new program is, at best, 
a disruptive, time-consuming and incon- 
venient process. At worst, it's like getting a 
mouthful of root canal jobs in one afternoon." 
(Jim Seymour, PC Magazine, April 12, 1988, 
p. 78.) 

"Why is programming fun? What delights 
may its practitioner expect as his reward? 
First is the sheer joy of making 
things .... Second is the pleasure of making 
things that are useful to other peo- 
ple. . . .Third is the fascination of fashioning 
complex puzzle-like objects of interlocking 
moving parts and watching them work in sub- 
tle cycles, playing out the consequences of 
principles built in from the begin- 
ning. . . .Fourth is the joy of always learning, 
which springs from the nonrepeating nature 
of the task .... Finally, there is the delight of 
working in such a tractable medi- 
um. . . .Programming, then, is fun because 
it gratifies creative longings built deep with- 
in us and delights sensibilities we have in 
common with all men." (Frederick P. Brooks 

Jr., The Mythical Man-Month, p. 7.) 
"I couldn't have said it better myself." (Karl 

Wiegers, January 24, 1989.) 




Karl Wiegers, Ph.D. , spent the 70s learn- 
ing how to be an organic chemist, then spent 
the '80s wrestling with computers. He is now 
a software engineer in the Eastman Kodak 
Company Photographic Research Labs. He 
hasn 't selected a career for the '90s yet. 

ANALOG invites all authors to submit es- 
says for possible use in the Footnotes column. 
Submissions should be no longer than 1,500 
words, and may be on any aspect of Atari 
computing. Any style or type of essay is 
acceptable— opinion, humor, personal 
experience— but creativity is a plus. Submis- 
sions should be sent to: Footnotes, c/o ANA- 
LOG, P.O. Box 1413-M.O. , Manchester, CT 
06040-1413. 
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FEATURE 



(CONTINUED FROM PAOf 1 1 T) 



STA (LINPTR), Y jnenory 
CLC 



jnext new line 



;next BASIC 



1588 

1590 

1600 

1610 

1620 

1630 

1640 

1650 

1660 

1670 

1680 

1690 

1700 

1710 

1720 

1730 

1740 

1750 

1760 ;handle special tokens 

1770 Jlike GOTO, GO TO, GOSUB 

1780 ;TRAP, RESTORE, LIST 

1790 ;which preceed line numbers 

1800 ; 

1810 T0K1 INV ;check for 
1820 LDA (LINPTR), Y 



LDA FLINE 

ADC ILIME 

STft FLINE 

LDft FLINE+1 

ADC ILINE+1 

STft FLINE+1 

INY 

LDft (LINPTR), Y ;line 

CLC 

ftDC LINPTR 

STft LINPTR 

LDft LINPTR+1 

ftDC 80 

STft LINPTR+1 

JMP D0R2 ;»ore! 



1830 CMP «14 

1840 BEQ GOTN 

1850 UAR JMP UARREF 

1860 GOTN STY YSflU 

1870 G0TN1 TYft 

1880 

1890 

1900 

1918 

1928 CMP 818 

1930 BEQ DONUM 

1940 CMP »28 

1950 BEQ DONUM 

1960 CMP »22 

1970 BNE UAR 

1988 DONUM LDY YSAV 

1990 J5R BCDINT 

2000 ; 

2010 ;now see if the new line exits 



;a number 
j constant 
jvariable refer 
jsave position 
;skip 7 bytes 

CLC ; f or constant 

ADC 87 

TAY 

LDA CLINPTR),Y ;get token 
jconna? 

jend stmt? 

;end line? 
jvariable ref 

;BCD to integer 






2828 


i 


2838 


LDA STMTAB ;point to 


2848 


STA SPTR ;line table 


2858 


LDA STMTAB+1 


2060 


STA SPTR+1 


2878 


LDA FLINE jlst new line 


2080 


STA FR8 


2090 


LDA FLINE+1 


2100 


STA FR0+1 


2110 


SEARCH LDY 81 ; check if exits 


2128 


LDA C5PTF!J,Y jhigh byte 


2138 


CMP 8$80 ;at end? 


2148 


BEQ NOTFND ;yes 


2158 


CMP RLINE+1 ;is it new line? 


2168 


BNE SNXTLN ; no 


2178 


DEY ; maybe-check 


2188 


LDA CSPTR),Y ;low byte 


2198 


CMP RLINE 


2288 


BNE shxtln jnope 


2218 


1 


2228 


;got natch fr8 has new line 8 



2238 ; 

2248 JSR IFP ;INT to FP 
2250 JSR INSERT jput it in 
2260 INY ;next token 

2270 LDA (LINPTR), Y 
2288 CMP ttl8 ;C0MMa? 
2298 BNE NOCOM ;no 
2388 JMP T0K1 jcheck for 8 
2318 NOCOM JMP GTNXST J next StMt 
2328 J 

2338 SNXTLN LDY 82 ; Offset to 
LDA C5PTR),Y jnext line 



2348 
2358 
2368 
2378 
2380 
2398 
2488 
2418 
2428 
2438 
2448 
2458 
2460 
2470 
2480 
2490 

2500 ;show variable reference nsg 
2510 ; 

2520 UARREF LDA 8'U 
2530 JSR PUTC 
2540 LDA 8'R 
2550 JSR PUTC 



CLC 
ADC SPTR 
STA SPTR 
LDA SPTR+1 
ftDC no 
STft SPTR+1 
CLC 

LDA FR0 
ADC ILINE 
STft FRO 
LDft FR0+1 
ADC ILINE+1 
STft FRO+1 
JMP SEARCH 



jMOue up to it 



jnove up 
;new line 
;to next one 
jin sequence 



jkeep looking 



;print 'UR- 



2560 

2570 

2580 

2590 

2600 

2610 

2628 

2638 

2648 

2658 

2668 

2678 

2688 

2698 

2788 

2710 

2720 

2730 

2748 

2750 

2760 

2770 

2780 

2790 

2800 

2810 

2820 

2830 

2840 

2858 

2860 

2870 

2880 

2890 

2908 

2918 

2928 

2930 

2948 

2950 

2960 

2978 

2980 

2990 

3000 

3818 

ken 

3828 

3038 

3840 

3050 

3088 

3878 

3888 

3898 

3188 

3118 

3128 

3138 

3148 

3158 

3160 

3170 

3180 

3190 

3200 

3210 

3220 

3230 

3240 

3250 

3260 

3270 

3280 

3290 

3300 

3310 

3320 

3330 

3340 

3350 

3360 

3370 

3380 

3390 

3400 

3410 

3420 

3430 

3440 

3450 

3460 

3470 

3488 

3498 

3588 

3518 

3528 



LDA «'- 
JSR PUTC 
NF1 LDA CLINE 
STA FR8 
LDA CLINE+1 
STA FRB+1 
JSR IFP 
JSR FftSC 
JSR PRNO 
JMP GTNXST 



;at current 
;line nnbr 



;change to FP 
jto ftTftSCll 
;print it 
;next stMt 



;show not found nsg 



NOTFND LDA tt* 

JSR PUTC 

LDA 8'F 

JSR PUTC 

LDA »'- 

JSR PUTC 

JMP NF1 



;print 'NF- 



;print line 8 



jcheck for ON GDTO/GOSUB 

T0K2 INY 

LDA (LINPTR), Y 

JON GOTO 



CMP 823 
BNE TK3 
TK4 JMP T0K1 
TK3 CMP 824 
BEQ TK4 
BNE T0K2 



jnope 

jyup 

JON GOSUB 

jyes 

jtry again 



jcheck for IF-THEN 

T0K3 INY 

LDA [LINPTR] ,Y J get token 

CMP 827 J THEN? 

BNE TOO j not yet 

INY jget next token 

LDA (LINPTR), Y 

CMP 814 j a constant? 

BNE NTNUM 

DEY j yes 

JMP T0K1 J process it 
NTNUM DEY J back up 1 byte 

JMP L4 J find if other to 



J convert BCD to INTEGER 

BCDINT LDX 88 J copy ATASCII 
BCD1 INY J to FR8 

LDA (LINPTR), Y 

STA FR0,X 



j 6 bytes 

JFP to INT 
jsave it 



INX 

CPX 86 
BNE BCD1 
JSR FPI 
LDA FR8 
STA RLINE 
LDA FR8+1 
STA RLINE+1 
RTS 

i 

j insert new line 



INSERT LDY YSAV jget position 

LDX 80 jMove FP 8 
INS1 INY jto position 

LDA FR0,X jin nenory 

STA (LINPTR), Y JOf line 

INX 

CPX 86 

BNE INS1 

RTS 
i 
j print line nunber 

PRNO JSR MPRINT jprint it 

LDA 8$20 

JSR PUTC 

LDX PRFLAG 

DEX 

BPL XR2 

JSR DOCR 

LDX 83 
XR2 STX PRFLAG 

RTS 



jprint LBUF 

MPRINT LDY 8$FF 

MPT INY 

LDA (INBUF),Y jget byte 
PHA jsave it 
AND 8$7F jnask inverse 
JSR PUTC jput it 

pla j last byte 



3538 


BPL MPT 


j is inversed 


3548 


RTS 




3558 


j 




3568 


jren & nun input checker 


3570 


jalso gets first line and 


3588 


j increnent fron 


input line 


3598 


i 




3688 


GETNBR JSR DEFAULT 


3618 


LDY 83 




3620 


LDA LBUF,Y 


jno 8's? 


3630 


CMP 8E0L 




3640 


BNE GETNMS 




3650 


RTS 


j no 8's! 


3660 


f 




3670 


;default values 


are 10,18 


3680 


J 




3690 


DEFAULT LDA 810 




3700 


STA FLINE 


jfirst line 


3710 


STA CLINE 




3720 


STA ILINE 


j and increnent 


3730 


LDA 80 




3740 


STA FLINE+1 




3750 


STA ILINE+1 




3760 


STA CLINE+1 




3770 


RTS 




3780 


J 




3790 


j find the last progran line 


3880 


J 




3810 


GLAST JSR DEFAULT J set defaults 


3828 


JSR GETPTR 


jpoint to 


3830 


LDY 81 


jfirst line 


3840 


LDA (LINPTR! 


,Y jget high 


3850 


BPL GLOK 


J< 32768? 


3868 


RTS 


jno! 


3870 


GLOK STA 1 


jsave line 8 


3888 


DEY 


jget low 


3898 


LDA (LINPTR! 


,t 


3980 


STA e 


jsave it 


3910 


JSR ADDLIN 


jnext line 


3920 


LDY 81 


jget high of 


3930 


LDA (LINPTR] 


,Y jline 


3940 


BPL GLOK 


J< 32768 


3958 


LDA 




3968 


CLC 




3978 


ADC ILINE 


jnove up 


3988 


STA FLINE 


juse last 


3998 


STA CLINE 


j nunber 


4000 


LDA 1 




4010 


ADC 80 


jhigh byte 


4020 


STA FLINE+1 




4030 


STA CLINE+1 




4048 


RTS 




4858 


i 




4868 


;set up for first tine use 


4070 


f 




4080 


SETNUM CLD 




4090 


LDA FLINE 


jback up 


4108 


5EC 


jone increnent 


4118 


SBC ILINE 


j fron first 


4128 


STA FLINE 


j line 


4138 


LDA FLINE+1 




4148 


SBC ILINE+1 




4150 


STA FLINE+1 




4160 


RTS 




4170 


f 




4180 


jget nunbers fron input 


4190 


i 




4200 


GETNMS LDX 80 




4210 


FNDCOM LDA LBUF, 


Y 


4220 


CMP 8' , 


jconna? 


4230 


BEQ GOTFST 




4240 


CMP 8EOL 


j done yet? 


4250 


BEQ GOTFST 




4260 


STA NBUF.X 


j copy nunber 


4270 


INX 


jout to NBUF 


4280 


CPX 86 




4290 


BEQ FPERR 


jerror if 


4300 


INY 


;too Many digits 


4310 


JMP FNDCOM 


j loop 


4320 


j 




4330 


jgot first line 


8-convert it 


4340 


jto integer fom 




4350 


\ 




4360 


GOTFST STA NBUF, 


X j, or EOL 


4370 


STY Y2 


jsave position 


4388 


LDA 80 


j set up FP 


4398 


STA CIX 


jstuff 


4488 


STA CLINE 




4410 


JSR DOINBF 


jpoint to NBUF 


4420 


JSR AFP 


J ATASCII to FP 


4430 


JSR FPI 


JFP to INT 


4440 


BCS FPERR 




4450 


LDA FR0+1 


j is nunber 


4468 


BMI FPERR 


j over 32768? 


4470 


STA FLINE+1 




4480 


STA CLINE+1 




4490 


LDA FR0 




4580 


STA FLINE 






(CONTINUED ON PAGE 131) 



NOVEMBER A.M.A.L.O.Q. Computing 



DIALOG BOXES IN O F A 



(CONTINUED FROM PAGE I 1 6) 

this function is used to get the address of 
the stored text. 

10. OB^X(adr% ,obj) sets or returns the 
x position of the object specified by obj 
relative to its parent object. The concept of 
parent and child needs some explaining. 
Let's say you create an object that is com- 
pletely contained within another object. A 
good example is a large box with several 
buttons within it. The large box is the "par- 
ent," while the buttons are the "children." 
Thus, this function would tell you the x 
coordinate of the specified button relative 
to the outer box. 

To get the x coordinate: X&=OB X 

(adr% ,object&) where the adr% is the ad- 
dress of the dialog box (returned by 
*RSRC_GADDR), and object& is the 
number of the object you want to know the 
x coordinate of (this number is set by the 
Resource Construction Set when you build 
the dialog box). To set the x coordinate: 
OB_X(adr % ,object&) =x& . 

11. OB_Y(adr%,obj) sets or returns the 
y position of the object specified by obj 
relative to its parent object. 

12. OB_W(adr%,obj) returns the width 
of the object in pixels. 

13. OB_H(adr%,obj) returns the height 
of the object in pixels. 

14. CHAR{address) returns or sets the 
null-terminated string at the address speci- 
fied. This function is extremely useful in 
finding out what text is in buttons, text fields 
and editable text fields, since these types 
of objects store their text as null-terminated 
strings. If we wanted to find out what text 
was in a G String- or G Button-type ob- 
ject, we would use the following: 
X$=CHAR { OB_SPEC(adr % ,object&) } 

because OB SPEC returns the address of 

the text in a G String- or G Button-type 

object. To set the text in a G String- or 

G Button-type object, we would use 

CHAR { OB_SPEC(adr % ,object&) } =X$. 
Note that the length of X$ must not be 
longer than the field length set when design- 
ing the dialog box, or you may crash your 
machine. 

Finding out what text is in text-type ob- 
jects (G_TEXT or G_BOXTEXT) or 
formatted (editable) text-type objects 
(G_FTEXT or G_FBOXTEXT) is a lit- 
tle more complicated: X$=CHAR{{OB_ 
SPEC(adr% ,object&)}} . Note the extra set 
of curly braces. OB_SPEC returns an ad- 
dress that points to another address, which 
in turn contains the address of the string. 
In GFA BASIC, the curly braces are placed 
around any term that will be handled as an 
address. Thus, this statement takes the ad- 



dress returned by OB SPEC, retrieves the 

address contained there (inner set of curly 
braces) and then reads the string contained 
at that address (CHAR{}). 

Finally, to set the text in a G TEXT-, 

G_BOXTEXT-, G_FTEXT- or 
G_FBOXTEXT-type object, use 
CHA R { { OB_SPEC(adr % ,object&) } } = 
X$. The same caveat about string length ap- 
plies here as well. 

STATES OF OBJECTS 

The "state" of an object refers to a graph- 
ic condition of that object. Each of the fol- 
lowing conditions corresponds to one bit in 
the variable that sets the state of the object: 

1. SELECTED (Bit 0, 00 0001): This state 
indicates that the object was selected and 
is thus shown in inverse text. Typically, this 
state occurs for the exit button of a dialog 
box after the user clicks on it with the 
mouse. As noted above, you should use 
OBJC_CHANGE to set the object back to 
a state of NONE (0), otherwise the exit but- 
ton will still be selected the next time the 
dialog box is drawn on the screen. 

2. CROSSED (Bit 1, 00 0010): This state 
places a cross inside the object. It is only 
meaningful with box-type objects. 

3. CHECKED (Bit 2, 00 0100): A check 
mark is drawn in the upper-left corner of 
the object. 

4. DISABLED (Bit 3, 00 1000): The ob- 
ject is grayed out and cannot be selected. 
This is helpful in preventing the user from 
making selections in the dialog box that 
don't make sense at the current time (for 
example, a NEXT button when there is no 
next piece of data to look at). 

5. OUTLINED (Bit 4, 01 0000): The ob- 
ject is drawn with a border. If it already had 
a border (a box-type object), then a second 
one is added. 

6. SHADOWED (Bit 5, 10 0000): The 
object is supplied with a drop shadow. 

SALUTING THE FLAGS 

The attributes of the elements in a dia- 
log box are set by their "flags." As with the 
state of an object, each flag detailed below 
corresponds to a bit set in the variable, 
which sets the object's attributes. There is 
even a command (OB__HvlG5) that returns 
the status of the flags for an object, but it 
is rarely used because the programmer al- 
ready knows the attributes of each object; 
he or she designed the object with the Re- 
source Construction Set, where these flags 
are set automatically. The common flags 
that can be set for an object are: 

1. SELECTABLE (Bit 0, 0000 0001): 
This object may be selected by the user. 



Most button objects must be selectable. 

2. DEFAULT (Bit 1, 0000 0010): Set- 
ting this flag causes two things to happen. 
The first is that pressing the return key 
selects this object automatically. Second, 
the object is drawn with a bold border to 
inform the user which object is the default. 
A dialog box should have only a single DE- 
FAULT object. 

3. EXIT (Bit 2, 0000 0100): Selecting 
this object ends the FORM_DO com- 
mand, returning control to the program. To 
select an object with an EXIT flag, the user 
must position the mouse pointer over the 
object, then press and release the left but- 
ton (See TOUCHEXIT). 

4. EDITABLE (Bit 3, 0000 1000): This 
object can be edited. It only makes sense 
for text fields to be EDITABLE. 

5. RBUTTON (Bit 4, 0001 0000): This 
object is a radio button. It belongs to a 
group of radio buttons that are contained 
within a parent object. Radio buttons are 
special because only one of the group can 
be selected at any time. If you select one 
radio button of a group, the inside is dar- 
kened to show that it is selected. If you then 
select a different button, the new radio but- 
ton is shown as selected, and the previous- 
ly selected one is set back to the 
non-selected condition. 

6. TOUCHEXIT (Bit 6, 0100 0000): 

Selecting this object ends the FORM DO 

command and returns command to the pro- 
gram. However, unlike the EXIT flag, to 
select a TOUCHEXIT object the user needs 
merely to place the mouse pointer inside the 
object and press the left button; it is not 
necessary to release it. This object is handy 
with certain types of buttons, as we shall 
soon see. 

CONCLUSION 

This is all the room we have this issue. 
Next time, we'll pick up our discussion 
where we left off, as well as take a look at 
the source code for a dialog box written in 
GFA BASIC 3.0. See you then, h 




David Plotkin has been pounding the 
keys on Atari computers for almost ten years 
now. In that time he has written many 
memorable programs and articles, which 
have been published in a variety of maga- 
zines. He holds an M.S. in chemical en- 
gineering and is a data analyst for Chevron 
Corporation. 
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FEATURE 



(CONTINUED ON PAGE 129; 



5R 



4518 


STA CLINE 


5490 


JSR SETLBF 


;set FP pointrs 


4520 


LDY Y2 ;get position 


5500 


LDA 810 


;VBI tiKier 


4530 


LDA LBUF,V ;check next 


5518 


STA TIMER 




4540 


CMP «E0L ;char. done? 


5528 


LDA tt0 




4550 


BNE GETSCN ; get second 


5538 


STA PROMPT 


; f or BASIC 


4560 


RT5 


5548 


STA CHRCNT 




4570 


J 


5558 


LDA 81 




4580 


;got first line ,now get 


5568 


STA ENDLIN 




4590 


;the incre«ent 


5578 


STA ONOFF 




4606 


i 


5588 


JMP EXIT2 




4610 


GETSCM LDX 80 


5598 






4620 


GT1 INY 


5680 


;point to next BASIC line 


4630 


LDA LBUF.Y ;get byte 


5618 






4640 


CMP 8E0L ;done? 


5628 


ADDLIN STY SLINE 




4650 


BEQ NUMDON ; yes 


5630 


LDY 82 




4660 


STA NBUF,X jcopy it 


5640 


LDA (LINPTR) 


,Y ;get offset 


4670 


INK ;too 


5650 


CLD 




4680 


CPX 86 jnany digits? 


5660 


CLC 


;nove pointer 


4690 


BEQ FPERR j yes 


5670 


ADC LINPTR 




4700 


JMP GT1 jKore 


5680 


STA LINPTR 




4710 


t 


5690 


LDA LINPTR+1 




4720 


) initialize INBUF 


5700 


ADC »0 




4730 


f 


5710 


STA LINPTR+1 




4740 


DOINBF LDA tt <NBUF ;point it 


5720 


LDY SLINE 




4750 


STA INBUF ;to NBUF 


5730 


RTS 




4760 


LDn tt >NBUF ;where the 


5740 


; 




4770 


STA INBUF+1 jnuhber is 


5750 


;get next basic 


line for VBI 


4780 


RTS 


5760 


i 




4790 


j 


5770 


INCLIN JSR ADDLIN 


4880 


;show floating point error 


5780 


STY SLINE 




4810 


i 


5790 


LDY tt8 




4820 


fperr PLA ;renove return 


5800 


LDA CLINPTR) 


,Y ;get low 


4830 


PLA 


5810 


STA RLINE 


;store it 


4840 


VALERR LDX ttll ; 'ERROR" 


5820 


INY 




4850 


FPER1 LDn FPMES,X ;nsg 


5830 


LDA CLINPTR3 


,Y ;high byte 


4860 


JSR PUTC 


5840 


STA RLINE+1 




4870 


DEX 


5850 


LDY SLINE 




4880 


BPL FPER1 


5860 


RTS 




4890 


JSR SETLBF ; reset FP 


5870 


/ 




4900 


JMP EXIT2 JtO BASIC 


5880 


; vertical blank 


interrupt 


4910 


1 


5890 


i 




4920 


;got paraweters so 


5900 


UBNUM LDA ENDLIN 


;BA5IC done? 


4930 


jprocess second nunber 


5910 


BEQ XITVBI 


; no 


4940 


; 


5920 


LDA PROMPT 




4950 


NUMDON STA NBUF,X ;E0L 


5930 


BEQ XITVBI 




4960 


LDn no 


5940 


LDA TIMER 


tine yet? 


4970 


STn CIX ;point to NBUF 


5950 


BEQ PRNUM 




4980 


JSR DOINBF 


5960 


DEC TIMER 


count down 


4990 


JSR AFP ;to FP 


5970 


JMP XITVBI 




5000 


JSR FPI JtO INT 


5980 


PRNUM LDA 80 




5010 


BC5 FPERR jerror! 


5998 


STA ENDLIN 




5020 


LDn FRO jput in 


6000 


LDA FLINE 


get line to 


5030 


STn iline ; increment 


6010 


CLC 


print 


5040 


LDA FRO+1 


6020 


ADC ILINE 


add incre«ent 


5050 


STA iline+i jerror if 


6030 


STA FLINE 




5060 


BMI FPERR J>=32768 


6840 


STA FRB 




5070 


JSR setlbf ; reset FP 


6050 


LDA FLINE+1 




5080 


RTS 


6060 


ADC ILINE+1 




5090 




6070 


STA FLINE+1 




5100 


jthis is the entry point 


6080 


STA FRB+1 




5110 


; for the auto numbering 


6090 


OVRCHK LDA FR8+1 


; i s it 


5120 


jsome ideas from ANALOG 


6100 


BMI VBQT 


over 32768? 


5130 


;issue 29 April 1985 


6118 


CMP RLINE+1 


exist already? 


5140 




6128 


BEQ VCKLO 


Maybe 


5150 


nUTNUM JSR GLA5T ;get params. 


6138 


BCC VBOK 


Ok 


5160 


LDA ttO 


6148 


JSR INCLIN 


look again 


5170 


STft ONOFF 


6158 


JMP OVRCHK 


check it 


5180 


i 


6168 


VCKLO LDA FRO 


low bytes 


5190 


;check for line overwrite 


6178 


CMP RLINE 


natch 


5200 


i 


6180 


BEQ VBQT 


yes-exit 


5210 


JSR GETPTR ;point to 


6190 


BCC VBOK 


ok 


5220 


NN1 LDY 80 J first line 


6200 


JSR INCLIN 


try next line 


5230 


LDn CLINPTR),Y ;get lineno 


6210 


JMP OVRCHK 


check it 


5240 


5TA RLINE ) low byte 


6220 


VBQT INC QTFLAG 


quit-exists 


5250 


INY 


6230 


LDA 812 


force return 


5260 


LDA CLINPTR3,Y Jhigh byte 


6240 


5TA 764 




5270 


STn RLINE+1 J is line 


6250 


JMP XITVBI 


out 


5288 


BMI NUMOK J>=32768 


6268 


1 




5298 


CMP FLINE+1 


6270 


; line 8 ok print 


it 


5388 


BEQ CKLOM JCheck low 


6280 


t 




5318 


BCS NUMOK JAOK 


6298 


VBOK JSR IFP 


to ATASCII 


5328 


NN2 JSR ADDLIN ;next line 


6300 


JSR FA5C 




5330 


JMP NN1 ; loop 


6310 


JSR MPRINT 


print it 


5340 


# 


6320 


LDA 8528 


space 


5350 


CKLOM LDA RLINE ;check low 


6330 


JSR PUTC 




5360 


CMP FLINE Jbyte 


6340 


JSR SETLBF 


reset FP ptrs 


5378 


BEQ NOnUTO jexits! 


6350 


XITVBI JMP XITVBV ; leave 


5380 


BCS NUMOK ;ok 








5390 


BCC NN2 ;check next 








5400 


NOAUTO JMP EXIT2 








5410 


i 








5420 


jparaweters ok 








5430 


; 








5448 


NUMOK JSR SETNUM Jback up 








5458 


LDA tt7 ;set UBI 








5468 


LDY tt <UBNUM 








5478 


LDX tt >UBNUM 








5480 


JSR SETUBU 
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